Shell 脚本不执行问题排查与解决

傲来云

在 Linux/Unix 系统中，Shell 脚本是运维、开发和自动化任务中最常用的工具之一。但在实际工作中，我们经常会遇到 “脚本不执行” 的情况，明明文件存在、命令看似正确，运行时却没有任何反应，或者报错信息让人费解。本文将系统梳理常见原因，并提供排查思路与解决方案。

一、检查脚本基本信息
1. 文件是否存在

1. ls -l /path/to/your/script.sh

复制代码

确认脚本路径正确，并且文件大小大于 0。

2. 文件权限
Shell 脚本必须有可执行权限才能运行：

1. chmod +x /path/to/your/script.sh

复制代码

执行：

1. ./script.sh

复制代码

如果没有执行权限，可能会提示：

1. bash: ./script.sh: Permission denied

复制代码

二、检查脚本的首行（Shebang）
Shell 脚本通常第一行定义解释器：

1. #!/bin/bash

复制代码

常见问题：
写成 #!/bin/sh 而系统 sh 实际指向 dash，脚本中使用了 bash 特性，就会报错。文件在 Windows 上编辑，存在 CRLF 换行符，Linux 下无法正确解析。
解决方法：

1. # 查看文件换行符
   
2. cat -v script.sh
   
3. # 将 CRLF 转换为 LF
   
4. dos2unix script.sh

复制代码

三、脚本调用方式问题
1. 使用 sh script.sh 运行
如果脚本以 bash 编写，但使用 sh script.sh 执行，可能出现语法错误。最好使用：

1. ./script.sh

复制代码

或者：

1. bash script.sh

复制代码

2. 路径问题
如果脚本不在当前目录，需要加上路径：

1. /path/to/script.sh

复制代码

或者将路径加入 PATH 并确认可执行权限。

四、排查脚本内容问题
1. 调试模式
在脚本首行或执行时加上 -x，可以显示执行过程：

1. bash -x script.sh

复制代码

2. 常见语法错误
多余或缺少 fi、done、}。
变量引用错误（缺少 $）。
命令路径不存在。

五、环境与依赖问题
1. 命令找不到
脚本中使用的命令可能在 $PATH 外，需要写全路径：

1. /usr/bin/grep

复制代码

2. 环境变量未加载
系统执行脚本时可能不会加载用户的 ~/.bashrc 或 ~/.profile。
可以在脚本开头手动设置环境变量：

1. export PATH=/usr/local/bin:/usr/bin:/bin

复制代码

六、权限与 SELinux 问题
用户权限不足：脚本中涉及操作系统资源或文件，需要确保当前用户有访问权限。
SELinux 或 AppArmor 限制：在安全增强模式下，脚本可能被阻止。可以临时查看：

1. sestatus

复制代码

如果是 SELinux 限制，可设置为 permissive 测试：

1. sudo setenforce 0

复制代码

七、总结排查流程
当 Shell 脚本不执行时，可以按以下顺序排查：
1. 文件存在与权限：ls -l / chmod +x
2. 首行 Shebang 与换行符：#!/bin/bash / dos2unix
3. 执行方式：./script.sh 或 bash script.sh
4. 调试脚本：bash -x script.sh
5. 命令与环境：确认命令存在 / PATH 配置正确
6. 系统安全限制：SELinux / AppArmor / 用户权限

八、实用小技巧
快速检查换行符

1. file script.sh

复制代码

打印当前 PATH

1. echo $PATH

复制代码

在脚本中加日志

1. #!/bin/bash
   
2. echo "$(date) Script started" >> /tmp/script.log

复制代码

结语
Shell 脚本不执行的问题往往并非单一原因，而是路径、权限、环境、格式等多种因素的组合。掌握系统排查流程，逐步验证每个环节，就能快速定位问题，并提高脚本可靠性和运维效率。