为何Shell脚本执行会失败

Shell 脚本执行失败的原因非常多，不能一概而论，下面按常见场景 + 示例给你系统性梳理，你可以对照排查。

一、权限问题（最常见）

现象

bash: ./test.sh: Permission denied

原因

脚本没有执行权限。

解决

chmod +x test.sh
./test.sh

或者用解释器直接执行（无需 +x）：

bash test.sh

二、解释器路径错误（shebang 问题）

错误示例

#!/bin/bash

但系统没有 /bin/bash

排查

which bash

推荐写法

#!/usr/bin/env bash

三、Windows 换行符（CRLF）问题 ⭐

现象

bash: ./test.sh: /bin/bash^M: bad interpreter

原因

脚本在 Windows 编辑，带回车符 \r\n

解决

dos2unix test.sh

或：

sed -i 's/\r$//' test.sh

四、脚本路径或命令不存在

示例

./foo.sh

如果 foo.sh 不在当前目录或 $PATH 中，会失败。

解决

• 使用绝对路径
• 或：

bash foo.sh

五、语法错误

常见示例

if [ $a -eq 1 ]
then
echo ok

缺少 fi

调试方法

bash -n test.sh   # 检查语法
bash -x test.sh   # 执行并显示过程

六、变量未定义或为空

示例

rm -rf $DIR/*

如果 DIR 为空：

rm -rf /*

防护写法

rm -rf "${DIR:?DIR is empty}/"

七、依赖命令不在 PATH 中

原因

脚本中用到的命令（如 java、python、curl）在执行环境中不存在。

解决

• 用绝对路径
• 或在脚本中指定 PATH

八、脚本以 source 方式执行出问题

区别

./test.sh

和

source test.sh

后者：

• 在当前 shell 执行
• 变量、exit 会影响当前环境

九、权限或环境限制（cron / sudo）

常见场景

• 手动执行成功
• cron 执行失败

原因

• cron 没有环境变量
• 路径不同

排查

env -i bash test.sh

十、简单通用排查模板（强烈推荐）

#!/usr/bin/env bash
set -euo pipefail

作用：

• set -e：命令失败立即退出
• set -u：未定义变量报错
• set -o pipefail：管道失败也报错

如果你愿意，我可以直接帮你定位问题

你可以贴出：

1. 脚本内容
2. 执行方式（命令）
3. 报错信息（完整）
4. 执行环境（Linux / macOS / 容器 / cron）

我可以直接告诉你哪一行为什么会失败。