静默失败:exit 0 却什么都没做,复现八种

exit 0 不等于做对了。本机复现七种静默失败:空转的 rm -f、未匹配的通配符、被管道吞掉的退出码,每种都有实测输出与防护写法。

目录
  1. 一、坑 1:rm -f 对不存在的文件返回 0
  2. 二、坑 2:通配符没匹配到时,字面量会被当成文件名
  3. 三、坑 3:管道吞掉上游退出码
  4. 四、坑 4:包装脚本无条件 exit 0
  5. 五、坑 5:2>/dev/null 把唯一的线索扔了
  6. 六、坑 6:目录不存在时 mkdir 忘了 -p
  7. 七、坑 7:退出码 126 + 零输出
  8. 八、坑 8:set -e 让你以为有保护
  9. 九、一张对照表:哪些命令的成功不可信
  10. 十、结论:三条硬规矩
  11. 下一步

自动化里最贵的故障不是"报错",而是**"没报错但也没做"**。报错会立刻中断流程,静默失败会一路往下跑,直到几天后你发现数据是空的。

下面八种我在 Windows + Git Bash 上逐一复现,输出是原样贴的。

一、坑 1:rm -f 对不存在的文件返回 0

bash
rm -f not_exist_at_all.txt
echo "exit=$?"
text
exit=0  <-- 0,但什么都没删

这是设计如此(-f 的含义就是"不存在的当成功")。危险在于它常被用在清理步骤里:

bash
# 危险:如果路径拼错,清理静默空转,接着跑构建,用的还是旧产物
rm -f build/*.js
npm run build

更隐蔽的变体是 rm -rf 加变量:

bash
# 变量为空时 == rm -rf /(GNU rm 有保护,但仍可能删掉当前目录内容)
rm -rf "$BUILD_DIR"/*

防护:清理关键产物时不要用 -f,或者先断言目标存在;带变量的删改一律先 set -u 再用:

bash
[ -d build ] && rm -rf build || { echo "build 目录不存在,终止"; exit 1; }

二、坑 2:通配符没匹配到时,字面量会被当成文件名

这是 bash 最经典的坑。空目录里跑:

bash
mkdir -p empty && cd empty
ls -A | wc -l      # 0  ← 确实空
for f in *.csv; do echo "saw: $f"; done
echo "exit=$?"
text
   目录条目数: 0
   saw: *.csv
   exit=0

循环体执行了一次,文件名字面量是 *.csv(因为 bash 默认 nullglob 关闭)。如果循环体是 rm "$f" 或 process "$f",你会收到"文件不存在"的错误——但如果你加了 2>/dev/null,就是彻底静默。

set -u 也救不了,因为这不是未定义变量:

bash
set -u
for f in *.json; do echo "saw: $f"; done   # saw: *.json  exit=0

防护二选一:

bash
shopt -s nullglob               # 没匹配到就展开成空,循环 0 次
# 或者显式判断
[ -e "$1" ] || { echo "no match"; exit 1; }

这一条在批处理里杀伤力特别大:你以为处理了 0 个文件是"没有任务",实际上可能是"路径写错了"。

三、坑 3:管道吞掉上游退出码

bash
( exit 7 ) | head -1
echo "pipeline exit=$?"
text
   pipeline exit=0  <-- 7 被丢掉

管道默认返回最后一个命令的退出码。开 pipefail 才对:

bash
set -o pipefail
( exit 7 ) | head -1
echo "with pipefail exit=$?"     # with pipefail exit=7

这一条差点让我误判过一次健康检查:

bash
# 反例:测试失败了但脚本报成功
python -m pytest 2>&1 | tail -20    # 退出码是 tail 的 0
echo "测试通过了吗?$?"              # 0 —— 假的

正确写法:set -euo pipefail 放在脚本第二行(第一行是 shebang)。

补一个容易忽略的点:set -e 本身也有漏洞。它不作用于条件语句、&&/|| 链里的命令、以及 ! 取反的命令。所以 cmd || true 这种写法会彻底关掉对这一行的错误检测——而它常被用来"防止脚本中断"。

四、坑 4:包装脚本无条件 exit 0

这个坑在"给非技术同事做一键脚本"时特别常见:

bash
printf '#!/usr/bin/env bash\nfalse\nexit 0\n' > wrapper.sh
chmod +x wrapper.sh
./wrapper.sh
echo "wrapper exit=$?"
text
   wrapper exit=0  <-- 内部 false 但外层 0

动机通常是"不想让用户看到红字"。但代价是上游的自动重试、告警全部失效。

防护:包装脚本用 exec 传递退出码,而不是重写:

bash
#!/usr/bin/env bash
set -euo pipefail
exec python real_task.py "$@"     # exec 保留真实退出码

五、坑 5:2>/dev/null 把唯一的线索扔了

bash
cp nothing.txt /path/no_such_dir/ 2>/dev/null
echo "cp exit=$?"
text
   cp exit=1  <-- 非 0,但被 2>/dev/null 藏起来了

这次退出码是对的,但错误原因没了。在 CI 日志里你只会看到 exit 1,然后花半小时猜。

我的规则:2>/dev/null 只允许用在**"失败可接受且原因已知"**的地方,比如探测性命令:

bash
# 可以:探测存在性,失败是预期结果
ls /optional/path 2>/dev/null

# 不可以:真实操作
cp a b 2>/dev/null    # ← 删掉这一步

替代方案是把 stderr 转到日志但继续:

bash
cp a b 2>>"$LOG" || { echo "cp 失败,见 $LOG"; exit 1; }

六、坑 6:目录不存在时 mkdir 忘了 -p

bash
mkdir /d/new/.scratch/p3/a/b/c 2>/dev/null
echo "mkdir exit=$?"
text
   mkdir exit=1 <-- 非 0

这个会报错,但只有在你检查退出码时。如果脚本没开 set -e,它继续往下跑,后面所有写文件的命令全部失败——而失败信息可能又被 2>/dev/null 吃掉。

这类连招(mkdir 失败 + 2>/dev/null + 无 set -e)产生的效果就是:脚本"成功",产物一个没有。

七、坑 7:退出码 126 + 零输出

这是我在横评里撞到的,最狠的一种。Windows 上 npm 生成的 .cmd 垫片被 timeout 包裹时:

bash
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 兜错,这个信号也被扔了。

绕过方法(不是修,是绕):

bash
timeout 20 sh -c 'codex --version'   # exit=0,正常

原因:timeout 只能直接 exec 真实可执行文件;.cmd 是批处理垫片,需要 cmd.exe 解释,跨这一层时执行失败并返回 126。

八、坑 8:set -e 让你以为有保护

前面七关都靠"开 set -e"来兜。但 set -e 本身有失效场景,而且失效时脚本照样 exit 0——这是最讽刺的一层静默。实测四种:

bash
#!/usr/bin/env bash
set -euo pipefail
false || true
echo "  第一行 false 被 || 吞掉,脚本继续"
grep -q zzz /etc/hostname || echo "  grep 没匹配也不中断"
echo "  到这儿说明 set -e 一次都没生效"

输出:

text
  第一行 false 被 || 吞掉,脚本继续
grep: /etc/hostname: No such file or directory
  grep 没匹配也不中断
  到这儿说明 set -e 一次都没生效
  脚本 exit=0

对照一下"裸命令"才能真正中断:

bash
set -euo pipefail
echo "  之前"
false
echo "  这一行不会打印"
text
  之前
  脚本 exit=1

四种失效场景归纳:

写法set -e 是否生效实测退出码
裸命令 false生效,立即中断1
false || true不生效,被 || 吸收0
if ! grep ...不生效,条件语句本就允许失败0
子 shell 里 set +e不生效,且不传染父 shell0

还有一个反方向的坑:set -e 太生效了。脚本里一句探测性的 grep 没匹配到,返回 1,整个脚本就死在那儿:

bash
set -euo pipefail
echo "  开始"
grep -q "绝不可能出现的字符串" /etc/hostname
echo "  这一行不会打印"
text
  开始
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

十、结论:三条硬规矩

踩完这些之后我定了三条,很土但有效:

bash
#!/usr/bin/env bash
set -euo pipefail          # 1. 任何脚本第二行就写这个
shopt -s nullglob          # 2. 通配符没匹配就当空
trap 'echo "失败于第 $LINENO 行,退出码 $?" >&2' ERR   # 3. 失败时留下位置

第三条特别值。有了它,报错会变成:

text
失败于第 27 行,退出码 1

你不用再猜是哪一步挂的。

下一步

拿你手上最常用的那个自动化脚本,做一次"反向测试":故意让它失败,看它报不报。把某个输入路径改成一个不存在的名字,跑一遍。如果它 exit 0 且没有明显错误,你刚找到一个静默失败点。

这个测试花 2 分钟,比事后排查两天便宜得多。