set -Eeuo pipefail 拦不住什么:if 条件、SIGPIPE 与 SSH 管道的退出码实测
四个开关各自改了什么
set -Eeuo pipefail 是四个独立选项的组合,并不等于“打开后脚本就安全了”。
-e(errexit):命令返回非 0 时退出 shell。-u(nounset):引用未定义变量视为错误。可选参数写${1:-default}。-o pipefail:管道退出状态从“最后一个命令”改成“最后一个非零退出码”。-E(errtrace):让 ERR trap 继承到函数、命令替换、子 shell 里。没有-E,函数内部失败不会触发外层 ERR trap。
ERR trap 里 $? 保存的是触发前的退出状态,先存再记录,否则 printf 一执行就丢了:
trap 'rc=$?; printf "ERR rc=%s at %s:%s\n" "$rc" "$BASH_SOURCE" "$LINENO" >&2' ERR
ERR trap 只做诊断,不改变控制流。它在条件上下文里不执行,也不是通用异常机制。
EXIT trap 做清理时要保留原退出状态:
cleanup() {
rc=$?
trap - EXIT
rm -rf "$workdir" || true
exit "$rc"
}
trap cleanup EXIT
SIGKILL 杀掉的进程不会跑 trap,别指望清理一定发生。
set -e 在条件上下文里失效
这是最容易踩的一条。命令处于 if、while/until 条件、&& / || 链的非末尾位置、或 ! 反转中时,set -e 不生效。&& / || 链里只有最右侧那条算数。
bash -c 'set -e; false || true; echo 1' # 输出 1
bash -c 'set -e; false && echo no; echo 2' # 输出 2
bash -c 'set -e; true && false; echo 3' # 不输出 3
第三行的 false 在链尾,会触发退出;前两行的失败命令不在判定位上。
更隐蔽的是:条件上下文里调用的函数,其内部的 set -e 一起失效。整个函数体被当作“条件表达式的一部分”,内部任意命令失败都不会中断,函数继续往下跑,最后返回 0。排查时看到“函数里明明有 set -e 却没停”,先看调用点是不是写在 if 里。
预期失败用 if 显式处理,不要无条件 || true。grep 无匹配退出 1,在严格模式下会直接终止:
printf 'a\nb\n' | grep '^z' # 严格模式下脚本在这里退出
if printf 'a\nb\n' | grep -q '^z'; then
echo found
fi
没有 pipefail 的 mysqldump | gzip
默认管道退出状态取最后一个命令,前面的全部丢弃:
bash -c 'false | true; echo $?' # 0
mysqldump app | gzip > backup.sql.gz
mysqldump 失败(权限、表锁、连接断),gzip 收到空输入照常压缩、照常以 0 退出。备份文件存在,大小几十字节,脚本报告成功。等真需要恢复时才发现是空文件。加上 pipefail 后同一个管道立刻非 0,事故从“恢复时发现”提前到“备份时告警”。
pipefail 带来的 141
pipefail 会把以前被吞掉的失败暴露出来,包括一些本来正常的失败:
set -o pipefail
yes | head -n 1 >/dev/null
echo "status=$? pipestatus=${PIPESTATUS[*]}"
# status=141 pipestatus=141 0
141 = 128 + 13,即 SIGPIPE。head 读够一行就关掉读端,yes 继续写管道,被内核用信号终止。这是符合预期的行为,不是 bug。
判定要按业务语义来,不能“非 0 一律失败”。写日志、采样、head 截断这类下游主动关闭读端的管道,141 是正常结束。真正要区分的是“生产者出错”和“消费者不想再看了”,前者报错,后者放行。SSH 记录管道状态时,这个例外要写在具体阶段旁边,而不是全局 || true。
PIPESTATUS 必须在管道结束后立刻复制
pipefail 只知道“最右侧的非零”,多个阶段同时失败时细节全丢。PIPESTATUS 是最近一次前台管道各阶段的退出码数组,下一条命令执行就把它覆盖。
错误写法:
source_data | normalize | upload
pipeline_rc=$?
printf 'pipeline result: %s\n' "$pipeline_rc"
statuses=("${PIPESTATUS[@]}") # 这里拿到的是 printf 的状态
正确写法是管道结束后第一件事就复制:
source_data | normalize | upload
statuses=("${PIPESTATUS[@]}")
printf 'pipeline result: %s\n' "${statuses[*]}"
PIPESTATUS 是 Bash 数组,不是 POSIX sh 语法。写到 #!/bin/sh 的脚本里、或者通过 ssh host 'command' 让远端默认 shell(dash、zsh)执行时,${PIPESTATUS[@]} 是空的,退出码就没了。
命令替换内部不继承 errexit
POSIX 规定命令替换在子 shell 里执行,errexit 默认不继承:
bash -c 'set -e; y=$(false; echo inner); echo "y=$y"'
# y=inner
false 失败了,后面的 echo inner 照跑,整个替换返回 0,外层毫不知情。Bash 4.4+ 提供 shopt -s inherit_errexit 修正这一点,但不能假设所有服务器都生效——CentOS 7 自带 Bash 4.2,没有这个选项。
同类问题在 local 上更常见:
set -e
f() { local x=$(false); echo in-f; }
f
Bash 3.2 下这段继续执行并整体成功,$(false) 的失败被 local 这条命令的状态盖掉。稳妥写法是把声明和赋值拆成两行:
local x
x=$(可能失败的命令)
这样赋值语句本身处于 set -e 的监管下。
cd 失败被吞掉,后续命令在错误目录里跑
裸 cd /no/such/dir 在严格模式下退出 1,没问题。问题出在把它包进条件上下文:
cd "$dir" || true # 后面 rm/cp/tar 在错误目录继续,还常常"成功"
cd "$dir" | tee log # cd 的退出码被 tee 的 0 盖住
ShellCheck 的 SC2164 专门检查这个:cd 之后跟 || exit 或 || return。第二种写法同时说明了一个规律——cd 左边进了管道,它的失败就不再是管道的最终状态。
BashPitfalls 里有个 cleanup 例子:
cleanup() { cd "$1"; rm -f ./*; }
cleanup /no/longer/there || { echo "no such dir"; exit 1; }
cleanup 处于 || 左侧,函数内 set -e 失效,cd 失败了 rm 照样对当前目录执行。正确写法让 cd 自己决定是否继续:
cleanup() { cd "$1" || return; rm -f ./*; }
SSH:本地 pipefail 管不了远程管道
build_manifest | sign_manifest | tee /var/tmp/manifest.json
build_manifest 失败,tee 仍会写出零字节文件并以 0 退出,管道报 0。这是本地场景,pipefail 能治。
换成 SSH,本地开关就失效了:
ssh deploy@host 'remote command' 2>&1 | tee session.log
这里有两条管道:远程 shell 内部的那条,和本地的 ssh | tee。pipefail 只作用于本地这条;远程管道各阶段的状态由远程 shell 自己负责,OpenSSH 不检查。本地 tee 成功,远程非零退出被掩盖。
ssh 返回 255 是客户端侧错误——连不上、认证失败、传输中断,不是某个远程阶段返回了 255。把它和业务退出码混在一起判断,日志里会出现“远程导出失败 rc=255”这种误导性结论。
要让远端用统一语义,显式起 bash,并用带引号的 heredoc 分隔符阻止本地展开:
ssh deploy@host 'bash -s' <<'REMOTE_SCRIPT'
set -Eeuo pipefail
...
REMOTE_SCRIPT
本地记录也要拆开:
set +e
ssh deploy@host 'bash -s' < remote-export.sh 2>&1 | tee ssh-export.log
local_status=("${PIPESTATUS[@]}")
set -e
ssh_rc=${local_status[0]}
tee_rc=${local_status[1]}
ssh_rc=255 按传输失败上报,不映射成任何远程阶段。
curl | bash 同理:
curl -fsS https://example.com/install.sh | bash
curl 遇到 404 默认退出 0 并输出错误页,bash 拿到一段 HTML 继续解析。-f(--fail)让 HTTP 错误直接非零并抑制输出,-sS 静默进度但保留错误信息。远程执行 curl | bash 时,还得远端自己开 pipefail,curl 的失败才能传到远端脚本。
什么场景不该用 set -e
三种情况会带来更多麻烦:
- 批处理需要逐条容忍部分失败、最后统一统计。
set -e遇到第一条失败就退出,统计做不完。改成显式if或收集$?更合适。 - 依赖的第三方程序退出码语义不稳定——非 0 表示“有警告”而不一定是“失败”。这时
set -e会把可恢复告警升级成中断。 - 脚本被上层编排调用,决策权本来就该留给调用方。脚本自己
exit掉,上层拿不到中间状态。
脚本骨架
#!/usr/bin/env bash
set -Eeuo pipefail
workdir=$(mktemp -d)
cleanup() {
rc=$?
trap - EXIT
rm -rf "$workdir" || true
exit "$rc"
}
trap cleanup EXIT
trap 'rc=$?; printf "ERR rc=%s at %s:%s\n" "$rc" "${BASH_SOURCE[0]}" "$LINENO" >&2' ERR
main() {
local dir=$1
cd "$dir" || return 1
local out
out=$(some_command) || return 1
source_data | normalize | upload
local status=("${PIPESTATUS[@]}")
if (( status[0] == 141 && status[1] == 0 )); then
: # 下游提前关闭,属正常
elif (( status[0] != 0 )); then
printf 'source_data failed: %s\n' "${status[0]}" >&2
return 1
fi
}
main "$@"
失败路径也要测:fail_23 | pass_through | succeed 期望拿到 23,0,0;再补 SSH 连不上、tee 不可写、预期 SIGPIPE 三种。只测 happy path 的严格模式,等于没开。