高级Bash脚本：错误处理的最佳实践

Bash脚本错误处理能防止一个小自动化错误演变成混乱的生产问题。如果备份失败、API调用返回错误或临时文件未被清理，你的脚本应明确停止，并将系统置于已知状态。

当你的脚本修改文件、部署代码、与远程服务通信或在无人监控终端的情况下运行时，请使用这些模式。

基础：理解退出码

Bash中执行的每个命令，无论成功还是失败，都会返回一个退出状态（或退出码）。这是指示命令结果的基本机制。

• 退出码0： 表示成功执行。按惯例，零表示成功。
• 退出码1-255（非零）： 表示错误、失败或警告。特定的非零码通常表示特定的错误类型（例如，1通常表示一般错误，2通常表示shell命令使用不当）。

最近的退出状态存储在特殊变量$?中。

# 成功命令
ls /tmp
echo "状态: $?"
# 状态: 0

# 失败命令（不存在的文件）
cat /nonexistent_file
echo "状态: $?"
# 状态: 1（或更高，取决于错误）

强制性最佳实践：实施严格模式

对于任何严肃的Bash脚本，应在shebang行之后立即放置三个指令。这些通常统称为“严格模式”。它们促使脚本在遇到破坏性前提条件时尽早失败。

1. 出错时立即退出（set -e）

set -e或set -o errexit命令指示Bash在任何命令以非零状态退出时立即退出脚本。这可以防止级联故障。

警告： 在条件测试（if、while）中，或如果命令是&&或||列表的一部分，set -e会被忽略。失败状态必须由周围结构显式使用。

2. 将未设置变量视为错误（set -u）

set -u或set -o nounset命令导致脚本在尝试使用尚未设置的变量（例如，将$FIELNAME误拼为$FILENAME）时立即退出。这可以防止因空变量或意外变量导致的难以调试的错误。

3. 处理管道中的错误（set -o pipefail）

默认情况下，如果一系列命令通过管道连接（例如，cmd1 | cmd2 | cmd3），Bash仅报告最后一个命令（cmd3）的退出状态。如果cmd1失败，脚本可能会继续成功执行。

set -o pipefail确保管道的退出状态是最后一个失败命令的退出状态，如果所有命令都成功则为零。这对于可靠的数据处理至关重要。

标准严格模式头部

始终以这个健壮的头部开始高级脚本：

#!/bin/bash

set -euo pipefail

一些旧模板还设置了IFS=$'\n\t'。仅在你理解它如何影响脚本其余部分中的单词分割时才使用它。引用变量并使用while IFS= read -r line读取输入通常更清晰。

条件错误检查

虽然set -e处理意外错误，但你通常需要检查特定条件或提供自定义错误消息。

使用if语句和自定义函数

不要仅依赖set -e，而是使用if块优雅地处理已知的潜在故障并提供描述性输出。

# 为一致性定义自定义错误函数
error_exit() {
    printf '[致命] %s\n' "$1" >&2
    exit 1
}

TEMP_DIR="/tmp/data_processing_$(date +%s)"

# 检查目录创建是否成功
if ! mkdir -p "$TEMP_DIR"; then
    error_exit "创建临时目录失败：$TEMP_DIR"
fi

echo "临时目录创建成功：$TEMP_DIR"

# 检查文件是否存在后再处理的示例
FILE_TO_PROCESS="input.csv"

if [[ ! -f "$FILE_TO_PROCESS" ]]; then
    error_exit "输入文件未找到：$FILE_TO_PROCESS"
fi

短路逻辑（&&和||）

对于简单的顺序操作，使用短路运算符。这非常易读且简洁。

• 成功链（&&）： 仅当第一个命令成功时，第二个命令才运行。
• 失败捕获（||）： 仅当第一个命令失败时，第二个命令才运行。

# 执行设置然后处理，如果设置失败则失败
setup_environment && process_data

# 尝试连接，否则优雅退出并显示消息
ssh user@server || { echo "连接失败，请检查网络设置。" >&2; exit 2; }

使用trap实现优雅终止和清理

trap命令允许脚本捕获信号（如Ctrl+C、系统终止或脚本退出）并在终止前执行指定的命令或函数。这对于清理任务至关重要。

cleanup函数

定义一个专用函数来撤销任何更改（例如，删除临时文件、重置配置），并使用trap确保无论脚本如何结束，它都会运行。

# 全局变量供清理函数检查
TEMP_FILE=""

cleanup() {
    printf '%s\n' "--- 运行清理程序 ---"
    if [[ -f "$TEMP_FILE" ]]; then
        rm -f "$TEMP_FILE"
        echo "已删除临时文件：$TEMP_FILE"
    fi
    # 可选地，提供最终退出状态报告
}

# 1. 捕获EXIT：无论成功、失败或信号，都运行清理。
trap cleanup EXIT

# 2. 捕获信号（INT=Ctrl+C，TERM=终止信号）
trap 'printf "%s\n" "脚本被用户或系统信号中断。" >&2; exit 130' INT
trap 'printf "%s\n" "脚本已终止。" >&2; exit 143' TERM

# --- 主脚本逻辑 ---
TEMP_FILE=$(mktemp)
echo "临时内容" > "$TEMP_FILE"
# 如果脚本在此处失败或被中断，cleanup()保证会运行

为什么使用trap cleanup EXIT？

在EXIT上设置trap保证无论脚本正常结束（exit 0）、显式出错退出（exit 1）还是因set -e强制终止，清理函数都会运行。

高级错误报告

标准错误消息（command not found）通常缺乏上下文。高级脚本应报告什么失败、在哪里失败以及为什么失败。

记录行号

当调用error_exit等函数时，你可以使用BASH_LINENO数组或caller命令（尽管caller通常限于函数内部）确定脚本中发生错误的行号。

对于函数外的简单报告，使用LINENO变量：

# 即时失败报告示例
(some_risky_command) || {
    echo "[错误 $LINENO] some_risky_command 失败，状态 $?" >&2
    exit 3
}

区分输出

始终将信息性消息发送到标准输出（stdout），将错误/警告消息发送到标准错误（stderr）。如果你的脚本输出被管道传输到另一个程序或外部记录，这一点至关重要。

• echo "信息性消息"（发送到stdout）
• echo "[警告] 配置覆盖" >&2（发送到stderr）

整合模式

对于大多数生产脚本，实用模式很简单：以set -euo pipefail开始，在执行工作前验证输入，将预期失败包装在if ! command; then ...; fi中，并在创建临时状态之前添加trap cleanup EXIT。

这能提供有用的失败信息，而不是神秘的失败。下次凌晨2点作业中断时，日志应显示失败内容、查找位置以及清理是否运行。