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

用 trap 统一清理临时资源

用 trap 统一清理临时资源

自动化脚本一旦中途失败,最危险的往往不是报错本身,而是遗留临时目录、锁文件或半完成状态。本节用 trap 把正常退出、异常退出和常见信号统一收口,让清理动作只写一次,并保留原始退出码与失败阶段。

学习目标

  • 理解 EXIT、INT、TERM 触发清理的时机
  • 写出幂等、不会吞掉原始退出码的清理函数
  • 在退出前记录失败阶段并删除临时资源

把所有退出路径收口到 trap

trap 的关键价值是把“主流程怎么结束”和“资源怎么回收”解耦。正常执行到文件末尾、set -e 触发退出、主动 exit,最终都会进入 EXIT 处理器;收到 INT 或 TERM 时,则先把信号转换为明确退出码,再让 EXIT 完成统一清理。

trap 统一收口退出与清理流程

不要在每个错误分支里重复 rm。分支越多,越容易遗漏;把资源句柄提前初始化,再由一个清理函数根据“资源是否已创建”决定是否处理,脚本会更容易维护。

写一个保留原始退出码的清理器

下面的脚本创建临时目录后故意执行失败命令。on_exit 先保存 $?,再解除 EXIT trap,防止清理阶段再次调用退出处理器,最后用原始状态码退出。

bash
#!/usr/bin/env bash
set -Eeuo pipefail

TMP_DIR=""
STEP="init"

cleanup() {
  local rc=$1
  set +e

  printf 'cleanup: rc=%d, step=%s, temp=%s\n' "$rc" "$STEP" "${TMP_DIR:-<none>}" >&2
  if [[ -n "${TMP_DIR:-}" && -d "$TMP_DIR" ]]; then
    rm -rf -- "$TMP_DIR"
  fi
}

on_exit() {
  local rc=$?
  trap - EXIT
  cleanup "$rc"
  exit "$rc"
}

on_signal() {
  local name=$1
  local code=$2
  printf 'signal: %s\n' "$name" >&2
  exit "$code"
}

trap on_exit EXIT
trap 'on_signal INT 130' INT
trap 'on_signal TERM 143' TERM

STEP="create-temp"
TMP_DIR=$(mktemp -d)
printf 'working dir: %s\n' "$TMP_DIR"

STEP="deploy"
false

预期输出

text
working dir: <PATH>
cleanup: rc=1, step=deploy, temp=<PATH>

<PATH> 是 mktemp 动态生成的目录,实际值每次运行都可能不同。脚本最终退出码为 1,说明清理逻辑没有把真正的失败原因改写成成功。

让清理动作具备幂等性

清理函数可能在资源只创建了一半时执行,因此不能假设所有文件都存在。对目录先判断 -d,删除时使用 rm -rf -- "$TMP_DIR",并让变量在注册 trap 前就有默认值,这样即使启用了 set -u 也不会因为未定义变量让清理再次失败。

如果脚本还创建锁文件、挂载点或临时凭据,同样按“存在才清理”的原则加入 cleanup。清理阶段通常应 set +e,因为某个次要资源删除失败,不应该覆盖主流程已经确定的退出码;但可以把清理失败写入日志,供后续排查。

区分 EXIT 与信号处理

EXIT 适合统一释放资源,INT 和 TERM 适合把外部中断转换成语义明确的状态码。常见约定是 INT=130、TERM=143,也就是 128 + 信号编号。不要在多个 trap 中各自重复删除同一资源,否则很容易出现重复执行、日志混乱或退出码被改写。

对于运维脚本,最稳妥的模式是:信号处理器只记录信号并 exit,真正的资源回收全部交给 EXIT。这样无论任务成功、命令失败还是被调度器终止,都会走同一条可验证的清理路径。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 trap 统一清理临时资源

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

登录哪都通