理解退出码：使用 $? 和 exit 进行有效错误处理

当 Bash 脚本失败时，退出码会告诉调用者接下来该做什么：继续、重试、告警或停止。理解退出码、$? 和 exit 是区分隐藏失败的自动化和清晰报告失败的自动化的关键。

本指南展示了 Bash 如何跟踪命令状态，以及如何利用该状态进行简单可靠的错误处理。

退出状态的概念

在类 Unix shell 环境中执行的每个命令或程序——无论是像 cd 这样的内置命令、像 grep 这样的外部工具，还是另一个 shell 脚本——在完成时都会返回一个整数值。这个整数就是退出码，它向调用进程指示操作的结果。

标准约定

退出码的约定是普遍认可的：

• 0（零）： 表示成功。命令完全按预期执行，未发生错误。
• 1 到 255： 表示失败或特定的错误条件。这些非零值表明出现了问题。较高的数字通常对应特定类型的错误（例如，文件未找到、权限被拒绝、语法错误），但具体含义取决于具体程序。

关于范围的说明： 虽然退出码在技术上是 8 位值（0-255），但 shell 脚本通常只关心 0 表示成功，非零表示失败。大于 255 的退出码通常会被 shell 截断或按模 256 解释。

检查上一个退出码：$? 变量

特殊的 shell 变量 $?（美元问号）是监控命令状态的核心。在任何命令执行后，shell 会立即将其退出码存储在 $? 中。

如何使用 $?

你必须在感兴趣的命令执行后立即检查 $?，因为任何后续命令（甚至回显该变量）都会覆盖其值。

示例 1：检查成功和失败

# 1. 一个成功的命令
echo "成功测试" > /dev/null
echo "成功的退出码：$?"

# 2. 一个失败的命令（例如，尝试列出一个不存在的文件）
ls /不存在的/路径
echo "失败的退出码：$?"

预期输出：

成功的退出码：0
ls: 无法访问 '/不存在的/路径': 没有那个文件或目录
失败的退出码：2

实现条件错误检查

仅仅知道退出码是不够的；真正的力量在于利用这些信息来控制脚本流程。这通常通过 if 语句或短路运算符（&& 和 ||）来实现。

使用 if 语句

这是最明确的错误处理方式：

if grep -q "重要数据" logfile.txt;
then
    echo "成功找到数据。"
else
    LAST_STATUS=$?
    echo "错误：Grep 失败，状态码为 $LAST_STATUS。未找到数据。"
    # 如果脚本无法继续，考虑在此处退出
fi

在上面的示例中，grep -q 抑制输出（-q），并且仅在找到匹配项时返回 0。if 结构会自动检查退出状态，但在 else 块中显式捕获 $? 对于详细日志记录很有用。

使用短路逻辑（&& 和 ||）

对于简单的顺序检查，短路运算符提供了简洁的错误处理：

• &&（与）： && 后面的命令仅在前一个命令成功（返回 0）时执行。
• ||（或）： || 后面的命令仅在前一个命令失败（返回非零）时执行。

示例 2：简洁的错误处理

# 1. 仅在 'fetch_data' 成功时运行 'process_data'
fetch_data.sh && ./process_data.sh

# 2. 仅在主操作失败时运行 'send_alert'
rsync -a source/ dest/ || echo "RSync 在 $(date) 失败" >> /var/log/rsync_errors.log

使用 exit 控制脚本终止

exit 命令用于立即终止当前 shell 脚本或函数，并向调用者（可能是另一个脚本或用户的终端）返回指定的退出状态。

语法和用法

语法很简单：exit [status_code]。

如果未提供状态，exit 默认为最近执行的前台命令的状态。如果你在未运行任何命令的情况下显式调用 exit 0，它将返回 0。

示例 3：前置条件失败时退出

此脚本确保在继续之前存在所需的配置文件。

CONFIG_FILE="/etc/app/config.conf"

if [[ ! -f "$CONFIG_FILE" ]]; then
    echo "错误：在 $CONFIG_FILE 未找到配置文件。"
    # 立即终止脚本并返回特定错误码（例如 20）
    exit 20 
fi

echo "配置已加载。继续执行脚本..."
# ... 脚本的其余部分
exit 0

最佳实践：使用有意义的退出码

虽然 0 和 1 涵盖了大多数基本情况，但使用不同的非零码有助于调用脚本诊断确切问题：

码值	含义（示例）
0	成功
1	通用捕获所有错误
2-10	语法错误、参数解析问题
20	缺少先决条件（例如，文件未找到）
30	权限问题

使脚本快速失败：set 命令

为了在复杂脚本中获得最大可靠性，强烈建议在脚本顶部使用 set 命令选项全局启用错误检查：

#!/bin/bash

# 如果命令以非零状态退出，则立即退出。
set -e

# 在替换时将未设置的变量视为错误。
set -u

# Pipefail：确保管道的返回状态是最后一个以非零状态退出的命令的状态。
set -o pipefail

# （可选但有用）为调试目的打印执行的命令
# set -x 

# 如果以下任何命令失败，脚本会立即停止。
ls /有效路径 && grep 模式 file.txt && ./next_step.sh

# 以下行仅在所有前面的命令成功时运行。
echo "所有步骤完成。"

当 set -e 激活时，许多未处理的非零状态会在后续命令基于错误假设运行之前停止脚本。它在条件语句、管道和复合命令中有例外，因此仍然要显式处理预期的失败。

例如，grep 在未找到匹配项时返回 1。这可能是一个正常结果，而不是致命错误：

if grep -q "READY" status.txt; then
    echo "服务已就绪。"
else
    echo "服务尚未就绪。"
fi

要点

在关键命令运行的地方检查它们，将错误写入 stderr，并在脚本无法安全继续时以非零状态退出。使用 set -euo pipefail 实现快速失败脚本，但不要将其作为唯一的错误处理策略。