Shell 脚本的容错与幂等
脚本出错不可怕,可怕的是错到一半还继续跑,或者重跑一次把数据删了。
运维脚本最常见的两个问题:出错了不停,和重跑一次结果不同。前者靠严格模式,后者靠幂等设计。
严格模式
bash
#!/usr/bin/env bash
set -euo pipefail
IFS=$'\n\t'-e:命令失败立即退出;-u:使用未定义变量报错;pipefail:管道中任一环失败就算失败;IFS:避免空格分词把文件名拆开。
注意 -e 在 if、&&、|| 的上下文中不生效,关键步骤仍要显式判断返回码。
变量与路径
bash
src="${1:?用法: $0 <源目录>}"
[[ -d "$src" ]] || { echo "目录不存在: $src" >&2; exit 1; }${1:?} 在参数缺失时直接报错退出;路径一律加引号,避免空格和通配符展开。
幂等
重跑不能产生副作用。创建前先判断,复制用覆盖,追加前先清空:
bash
mkdir -p /srv/app
install -d -m 0755 /srv/app/data删除类操作要更谨慎:先算出目标,再打印,再执行,最好带 --dry-run 开关。
bash
find /srv/app/tmp -type f -mtime +7 -print # 先看
find /srv/app/tmp -type f -mtime +7 -delete # 再删日志与锁
bash
exec 9>/var/lock/mytask.lock
flock -n 9 || { echo "已有实例在运行"; exit 0; }日志带时间戳和阶段标记,出问题时能看出停在哪一步。
不要在管道里直接 rm
find ... | xargs rm 在文件名含空格或换行时会删错文件。用 -print0 配 xargs -0,或者直接用 find -delete。
退出码
脚本的成功不是“跑完了”,而是“结果符合预期”。最后做一次校验,失败返回非 0,调度器才能感知。
小结
严格模式防“带病继续”,幂等防“重跑翻车”,日志和锁防“查不到、撞一起”。三样都不复杂,但能省很多事故。
说明:文中的地址、域名、主机名与账号均为脱敏示例;配置片段来自实际环境,但版本与网络条件不同,照搬前请先在测试环境验证。最后校对:2026-05-30。