Bash set -euo pipefail 实战:让 Shell 脚本提前暴露错误
写过 Shell 脚本的人,大概都遇到过这样的场景:脚本跑完了,退出码是 0,日志里也没有报错,可结果就是不对。查了半天才发现,中间某一步早就失败了。Shell 默认的容错策略其实很“宽容”:命令失败不退出、未定义变量当作空串、管道只看最后一个命令的退出码。三者叠加,就是很多线上故障的源头。
一、三个默认行为为什么危险
第一个是命令失败不退出。默认情况下,脚本中某条命令返回非零退出码,Bash 不会停下来,而是继续执行下一条命令。如果是创建目录或备份数据,后续步骤拿到的就是错误输入,越跑错得越远。
第二个是未定义变量当空串。拼写错误最常见,把 BACKUP_DIR 写成 BACKUP_DRI,Bash 不会报错,而是把它当成空字符串。一旦变量为空,rm -rf $BACKUP_DIR/* 就可能删错东西。
第三个是管道只看最后一个命令。cat file | grep key | wc -l 这样的管道,Bash 只关心 wc -l 的退出码。即使 cat 找不到文件,管道退出码仍然是 0,错误就这样被吞掉了。
二、一行配置改变默认行为
解决办法只有一行,写在脚本开头:
#!/bin/bash
set -euo pipefail
这行配置由三个选项组成。set -e 让命令失败时脚本立即退出;set -u 让引用未定义变量时直接报错退出;set -o pipefail 让管道中任何一个命令失败,整个管道就返回非零退出码,管道里的错误再也藏不住。
三、实战:备份脚本对比
来看一个备份脚本。没有这行配置时,目录创建失败、打包失败都不会中断脚本,脚本最后还会输出“备份完成”,把失败的备份当成成功:
#!/bin/bash
BACKUP_DIR=/data/backup/$(date +%Y%m%d)
mkdir -p "$BACKUP_DIR"
tar -czf "$BACKUP_DIR/app.tar.gz" /data/app
加上之后,mkdir 失败立即退出,tar 打包失败同样立即退出,变量名写错也会第一时间报错。脚本从“尽量跑完”变成了“有错就停”,这才是自动化脚本该有的样子。
四、写脚本的三条习惯
第一,脚本开头固定写上 set -euo pipefail,把它当成模板的一部分。第二,变量一律用双引号包裹,“$BACKUP_DIR” 比 $BACKUP_DIR 更安全。第三,关键步骤后打印一条日志,方便定位失败位置。
Shell 脚本最大的风险不是语法难,而是错误被悄悄吞掉。set -euo pipefail 不能保证脚本没有 bug,但它能保证 bug 一出现就被发现,而不是在深夜告警里才暴露。
- 点赞
- 收藏
- 关注作者
评论(0)