静默失败:exit 0 却什么都没做,复现八种
exit 0 不等于做对了。本机复现七种静默失败:空转的 rm -f、未匹配的通配符、被管道吞掉的退出码,每种都有实测输出与防护写法。
目录
自动化里最贵的故障不是"报错",而是**"没报错但也没做"**。报错会立刻中断流程,静默失败会一路往下跑,直到几天后你发现数据是空的。
下面八种我在 Windows + Git Bash 上逐一复现,输出是原样贴的。
一、坑 1:rm -f 对不存在的文件返回 0
rm -f not_exist_at_all.txt
echo "exit=$?"exit=0 <-- 0,但什么都没删这是设计如此(-f 的含义就是"不存在的当成功")。危险在于它常被用在清理步骤里:
# 危险:如果路径拼错,清理静默空转,接着跑构建,用的还是旧产物
rm -f build/*.js
npm run build更隐蔽的变体是 rm -rf 加变量:
# 变量为空时 == rm -rf /(GNU rm 有保护,但仍可能删掉当前目录内容)
rm -rf "$BUILD_DIR"/*防护:清理关键产物时不要用 -f,或者先断言目标存在;带变量的删改一律先 set -u 再用:
[ -d build ] && rm -rf build || { echo "build 目录不存在,终止"; exit 1; }二、坑 2:通配符没匹配到时,字面量会被当成文件名
这是 bash 最经典的坑。空目录里跑:
mkdir -p empty && cd empty
ls -A | wc -l # 0 ← 确实空
for f in *.csv; do echo "saw: $f"; done
echo "exit=$?" 目录条目数: 0
saw: *.csv
exit=0循环体执行了一次,文件名字面量是 *.csv(因为 bash 默认 nullglob 关闭)。如果循环体是 rm "$f" 或 process "$f",你会收到"文件不存在"的错误——但如果你加了 2>/dev/null,就是彻底静默。
set -u 也救不了,因为这不是未定义变量:
set -u
for f in *.json; do echo "saw: $f"; done # saw: *.json exit=0防护二选一:
shopt -s nullglob # 没匹配到就展开成空,循环 0 次
# 或者显式判断
[ -e "$1" ] || { echo "no match"; exit 1; }这一条在批处理里杀伤力特别大:你以为处理了 0 个文件是"没有任务",实际上可能是"路径写错了"。
三、坑 3:管道吞掉上游退出码
( exit 7 ) | head -1
echo "pipeline exit=$?" pipeline exit=0 <-- 7 被丢掉管道默认返回最后一个命令的退出码。开 pipefail 才对:
set -o pipefail
( exit 7 ) | head -1
echo "with pipefail exit=$?" # with pipefail exit=7这一条差点让我误判过一次健康检查:
# 反例:测试失败了但脚本报成功
python -m pytest 2>&1 | tail -20 # 退出码是 tail 的 0
echo "测试通过了吗?$?" # 0 —— 假的正确写法:set -euo pipefail 放在脚本第二行(第一行是 shebang)。
补一个容易忽略的点:set -e 本身也有漏洞。它不作用于条件语句、&&/|| 链里的命令、以及 ! 取反的命令。所以 cmd || true 这种写法会彻底关掉对这一行的错误检测——而它常被用来"防止脚本中断"。
四、坑 4:包装脚本无条件 exit 0
这个坑在"给非技术同事做一键脚本"时特别常见:
printf '#!/usr/bin/env bash\nfalse\nexit 0\n' > wrapper.sh
chmod +x wrapper.sh
./wrapper.sh
echo "wrapper exit=$?" wrapper exit=0 <-- 内部 false 但外层 0动机通常是"不想让用户看到红字"。但代价是上游的自动重试、告警全部失效。
防护:包装脚本用 exec 传递退出码,而不是重写:
#!/usr/bin/env bash
set -euo pipefail
exec python real_task.py "$@" # exec 保留真实退出码五、坑 5:2>/dev/null 把唯一的线索扔了
cp nothing.txt /path/no_such_dir/ 2>/dev/null
echo "cp exit=$?" cp exit=1 <-- 非 0,但被 2>/dev/null 藏起来了这次退出码是对的,但错误原因没了。在 CI 日志里你只会看到 exit 1,然后花半小时猜。
我的规则:2>/dev/null 只允许用在**"失败可接受且原因已知"**的地方,比如探测性命令:
# 可以:探测存在性,失败是预期结果
ls /optional/path 2>/dev/null
# 不可以:真实操作
cp a b 2>/dev/null # ← 删掉这一步替代方案是把 stderr 转到日志但继续:
cp a b 2>>"$LOG" || { echo "cp 失败,见 $LOG"; exit 1; }六、坑 6:目录不存在时 mkdir 忘了 -p
mkdir /d/new/.scratch/p3/a/b/c 2>/dev/null
echo "mkdir exit=$?" mkdir exit=1 <-- 非 0这个会报错,但只有在你检查退出码时。如果脚本没开 set -e,它继续往下跑,后面所有写文件的命令全部失败——而失败信息可能又被 2>/dev/null 吃掉。
这类连招(mkdir 失败 + 2>/dev/null + 无 set -e)产生的效果就是:脚本"成功",产物一个没有。
七、坑 7:退出码 126 + 零输出
这是我在横评里撞到的,最狠的一种。Windows 上 npm 生成的 .cmd 垫片被 timeout 包裹时:
timeout 20 codex --version
echo "exit=$?" # 126
timeout 20 codex --version > out.txt 2> err.txt
wc -c out.txt err.txt # 0 0 ← 两边都是空退出码非 0,但 stdout 和 stderr 都是 0 字节。 日志里干净得像成功,只有退出码在喊。而如果你的脚本用 || true 兜错,这个信号也被扔了。
绕过方法(不是修,是绕):
timeout 20 sh -c 'codex --version' # exit=0,正常原因:timeout 只能直接 exec 真实可执行文件;.cmd 是批处理垫片,需要 cmd.exe 解释,跨这一层时执行失败并返回 126。
八、坑 8:set -e 让你以为有保护
前面七关都靠"开 set -e"来兜。但 set -e 本身有失效场景,而且失效时脚本照样 exit 0——这是最讽刺的一层静默。实测四种:
#!/usr/bin/env bash
set -euo pipefail
false || true
echo " 第一行 false 被 || 吞掉,脚本继续"
grep -q zzz /etc/hostname || echo " grep 没匹配也不中断"
echo " 到这儿说明 set -e 一次都没生效"输出:
第一行 false 被 || 吞掉,脚本继续
grep: /etc/hostname: No such file or directory
grep 没匹配也不中断
到这儿说明 set -e 一次都没生效
脚本 exit=0对照一下"裸命令"才能真正中断:
set -euo pipefail
echo " 之前"
false
echo " 这一行不会打印" 之前
脚本 exit=1四种失效场景归纳:
| 写法 | set -e 是否生效 | 实测退出码 |
|---|---|---|
裸命令 false | 生效,立即中断 | 1 |
false || true | 不生效,被 || 吸收 | 0 |
if ! grep ... | 不生效,条件语句本就允许失败 | 0 |
子 shell 里 set +e | 不生效,且不传染父 shell | 0 |
还有一个反方向的坑:set -e 太生效了。脚本里一句探测性的 grep 没匹配到,返回 1,整个脚本就死在那儿:
set -euo pipefail
echo " 开始"
grep -q "绝不可能出现的字符串" /etc/hostname
echo " 这一行不会打印" 开始
grep: /etc/hostname: No such file or directory
脚本 exit=2注意这次退出码是 2——不是 1,因为 grep 把"文件不存在"(2)和"无匹配"(1)分开了。所以判断"有没有匹配"时,必须写 grep -q ... || true 或放进 if。
结论:set -e 是必需但不充分的。真正可靠的做法是显式检查关键步骤的返回值,而不是指望全局开关。
九、一张对照表:哪些命令的成功不可信
| 命令形态 | 静默风险 | 防护 |
|---|---|---|
rm -f <可能不存在> | 高 | 关键产物去掉 -f,或先断言 |
for f in *.ext | 高 | shopt -s nullglob |
cmd | head/tail | 中 | set -o pipefail |
| 包装脚本 | 高 | exec 而非 exit 0 |
2>/dev/null | 高 | 只在探测时使用 |
mkdir <多级> | 中 | 加 -p |
cmd || true | 高 | 删掉,或记录后再放行 |
.cmd 垫片 + timeout | 高 | 用 sh -c 包一层 |
set -e + ` | true/if` / 子 shell |
十、结论:三条硬规矩
踩完这些之后我定了三条,很土但有效:
#!/usr/bin/env bash
set -euo pipefail # 1. 任何脚本第二行就写这个
shopt -s nullglob # 2. 通配符没匹配就当空
trap 'echo "失败于第 $LINENO 行,退出码 $?" >&2' ERR # 3. 失败时留下位置第三条特别值。有了它,报错会变成:
失败于第 27 行,退出码 1你不用再猜是哪一步挂的。
下一步
拿你手上最常用的那个自动化脚本,做一次"反向测试":故意让它失败,看它报不报。把某个输入路径改成一个不存在的名字,跑一遍。如果它 exit 0 且没有明显错误,你刚找到一个静默失败点。
这个测试花 2 分钟,比事后排查两天便宜得多。