Linux 与服务器运维 / 系统课时
写出失败即停的 Bash 脚本
写出失败即停的 Bash 脚本
运维脚本最危险的情况不是“报错”,而是某一步已经失败,后面的删除、覆盖或重启仍继续执行。本篇用严格模式、统一错误出口和参数校验组织一个可直接运行的 Bash 脚本,让失败尽早暴露,并保留足够的定位信息。
学习目标
- 使用
set -Eeuo pipefail阻止常见的静默失败 - 用参数检查、函数和退出码表达可预期错误
- 用
ERRtrap 输出失败命令并验证脚本确实中止
严格模式解决哪些问题
Bash 默认会容忍不少异常:普通命令返回非零后脚本仍可能继续;未定义变量会展开为空字符串;管道默认只看最后一个命令的退出码。对运维任务来说,这些行为容易把一次小故障放大成配置损坏。
常用入口是:
set -Eeuo pipefail其中 -e 让未被显式处理的失败终止脚本,-u 禁止读取未定义变量,pipefail 让管道任一环节失败都能传递出来,-E 让 ERR trap 在函数等上下文中继续生效。
用统一出口处理可预期错误
下面脚本接收“源文件”和“目标目录”两个参数。参数数量、文件存在性和目录可写性属于可预期错误,直接调用 die;真正的命令执行失败则交给 ERR trap 记录。
#!/usr/bin/env bash
set -Eeuo pipefail
die() {
printf 'ERROR: %s\n' "$*" >&2
exit 2
}
on_err() {
local code=$?
printf 'ERROR: line=%s command=%q exit=%s\n' "${BASH_LINENO[0]}" "$BASH_COMMAND" "$code" >&2
exit "$code"
}
trap on_err ERR
[[ $# -eq 2 ]] || die "用法: $0 <source-file> <target-dir>"
source_file=$1
target_dir=$2
[[ -f "$source_file" ]] || die "源文件不存在: $source_file"
[[ -d "$target_dir" ]] || die "目标目录不存在: $target_dir"
[[ -w "$target_dir" ]] || die "目标目录不可写: $target_dir"
target_file="$target_dir/$(basename -- "$source_file")"
cp -- "$source_file" "$target_file"
test -s "$target_file" || die "复制后文件为空: $target_file"
printf 'OK: %s\n' "$target_file"脚本中的 -- 用来结束选项解析,避免文件名以 - 开头时被命令误认为参数。die 固定返回退出码 2,便于调用方区分“输入错误”和底层命令失败。
运行并观察退出行为
将脚本保存为 safe-copy.sh 后执行:
chmod +x safe-copy.sh
tmp_dir="$(mktemp -d)"
printf 'server_name=demo\n' > "$tmp_dir/app.conf"
mkdir "$tmp_dir/out"
./safe-copy.sh "$tmp_dir/app.conf" "$tmp_dir/out"预期输出:
OK: <PATH>/out/app.conf<PATH> 是 mktemp 创建的实际临时目录,每次运行都可能不同。再传入一个不存在的源文件:
./safe-copy.sh "$tmp_dir/missing.conf" "$tmp_dir/out"
printf 'exit=%s\n' "$?"预期输出:
ERROR: 源文件不存在: <PATH>/missing.conf
exit=2这里的失败发生在参数与状态检查阶段,因此不会执行 cp。如果是 cp 本身因为磁盘、权限等原因失败,ERR trap 会输出失败行、命令和原始退出码,然后立即结束脚本。
给失败保留清晰边界
“失败即停”不等于把所有非零状态都交给 set -e。像 grep 未匹配、探测服务是否存在这类结果,本来就可能用非零表示“条件不成立”,应放进 if 或显式处理退出码。真正会改变系统状态的命令,则应让异常直接冒泡并停止后续步骤。
一个可靠的运维脚本应做到:入口参数先验证,可预期分支自己处理,未预期失败统一记录并终止。这样调用者既能看懂错误,也能依靠退出码决定是否重试、告警或停止批量任务。