Linux 与服务器运维 / 系统课时

写出失败即停的 Bash 脚本

写出失败即停的 Bash 脚本

运维脚本最危险的情况不是“报错”,而是某一步已经失败,后面的删除、覆盖或重启仍继续执行。本篇用严格模式、统一错误出口和参数校验组织一个可直接运行的 Bash 脚本,让失败尽早暴露,并保留足够的定位信息。

学习目标

  • 使用 set -Eeuo pipefail 阻止常见的静默失败
  • 用参数检查、函数和退出码表达可预期错误
  • 用 ERR trap 输出失败命令并验证脚本确实中止

严格模式解决哪些问题

Bash 默认会容忍不少异常:普通命令返回非零后脚本仍可能继续;未定义变量会展开为空字符串;管道默认只看最后一个命令的退出码。对运维任务来说,这些行为容易把一次小故障放大成配置损坏。

常用入口是:

bash
set -Eeuo pipefail

其中 -e 让未被显式处理的失败终止脚本,-u 禁止读取未定义变量,pipefail 让管道任一环节失败都能传递出来,-E 让 ERR trap 在函数等上下文中继续生效。

用统一出口处理可预期错误

下面脚本接收“源文件”和“目标目录”两个参数。参数数量、文件存在性和目录可写性属于可预期错误,直接调用 die;真正的命令执行失败则交给 ERR trap 记录。

bash
#!/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 后执行:

bash
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"

预期输出:

text
OK: <PATH>/out/app.conf

<PATH> 是 mktemp 创建的实际临时目录,每次运行都可能不同。再传入一个不存在的源文件:

bash
./safe-copy.sh "$tmp_dir/missing.conf" "$tmp_dir/out"
printf 'exit=%s\n' "$?"

预期输出:

text
ERROR: 源文件不存在: <PATH>/missing.conf
exit=2

这里的失败发生在参数与状态检查阶段,因此不会执行 cp。如果是 cp 本身因为磁盘、权限等原因失败,ERR trap 会输出失败行、命令和原始退出码,然后立即结束脚本。

给失败保留清晰边界

“失败即停”不等于把所有非零状态都交给 set -e。像 grep 未匹配、探测服务是否存在这类结果,本来就可能用非零表示“条件不成立”,应放进 if 或显式处理退出码。真正会改变系统状态的命令,则应让异常直接冒泡并停止后续步骤。

一个可靠的运维脚本应做到:入口参数先验证,可预期分支自己处理,未预期失败统一记录并终止。这样调用者既能看懂错误,也能依靠退出码决定是否重试、告警或停止批量任务。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

写出失败即停的 Bash 脚本

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通