Linux Bash脚本错误处理怎么写,如何区分命令失败与可忽略返回值
首次运行 Bash 脚本时,目标不是让每条命令都返回 0,而是让脚本准确区分两件事:找不到匹配项这类符合业务预期的返回值,以及读取失败、写入失败等必须终止的错误。以下在 Linux 上用一个独立临时目录完成配置检查、生成报告和失败验证,不需要修改系统服务或线上配置。
Bash 主要通过命令的退出状态作判断:0 通常表示成功,非 0 的含义则由具体命令定义。set -e 可以让不少未处理的失败终止脚本,但它不知道业务上哪些状态可以接受;实施时应先为预期分支写明处理规则,再让其余失败向外传播。
A5idc数据提供中国香港、美国、日本、韩国、中国台湾、新加坡和马来西亚等地区的物理服务器资源,覆盖常规建站、业务后台、数据库、接口服务及多任务运行场景。不同产品配备相应的CPU、内存、SSD或NVMe存储,并提供多种带宽线路,为Linux环境下的Bash脚本部署、配置检查、报告生成和日常运维任务提供稳定的硬件与网络基础。
准备条件:确认环境并划定写入范围
示例适用于 Linux 上的 Bash,以及提供 mktemp、grep、wc 等常用命令的环境。请用 Bash 运行,不要用 sh 代替;sh 可能指向另一种 shell。先确认版本和命令是否可用:
bash --version
command -v mktemp grep wc
预期是显示 Bash 版本,并分别打印三个命令的路径;有命令查不到时,先在本机确认软件包与执行环境,不要直接运行后续示例。以下所有示例文件只放在新建的临时目录中。workdir 变量须在同一个终端会话内保留,后续命令才会指向同一目录。
umask 077
workdir=$(mktemp -d "${TMPDIR:-/tmp}/bash-error-demo.XXXXXXXX") || exit 1
printf 'WORKDIR=%s\n' "$workdir"
printf '%s\n' 'feature=on' 'note=test' > "$workdir/settings.txt"
预期得到一条临时目录路径,其中的 settings.txt 有两行。umask 077 限制本次创建文件的默认权限;仍应避免把密码等生产机密写进演示文件。创建、写入或检查任一步失败,应先确认磁盘空间、目录权限与变量值,不要改用系统配置路径继续尝试。
第一步:写入首次运行的检查脚本
将以下脚本保存到刚创建的目录。它只接受一个工作目录参数,读取其中的 settings.txt,并创建 report.txt。报告采用禁止覆盖的写法:同一目录重复运行不会静默替换已有报告。
cat > "$workdir/check.sh" <<'BASH'
#!/usr/bin/env bash
set -euo pipefail
fatal() {
local status=$1
shift
printf 'fatal: %s (status=%s)\n' "$*" "$status" >&2
exit "$status"
}
trap 'status=$?; printf "unexpected failure (status=%s)\n" "$status" >&2; exit "$status"' ERR
main() {
local dir=$1
local input=$dir/settings.txt
local report=$dir/report.txt
local state grep_status lines
[[ -f $input ]] || fatal 66 "input is not a regular file: $input"
if grep -F -x 'feature=on' "$input" > /dev/null; then
state=on
else
grep_status=$?
case $grep_status in
1) state=off ;;
*) fatal "$grep_status" "grep could not read: $input" ;;
esac
fi
lines=$(wc -l < "$input")
(set -C; printf 'feature=%s\nlines=%s\n' "$state" "$lines" > "$report")
printf 'created: %s\n' "$report"
}
if (( $# != 1 )); then
fatal 64 'usage: bash check.sh WORKDIR'
fi
main "$1"
BASH
bash -n "$workdir/check.sh"
bash -n 没有输出且返回 0,表示语法检查通过;它不代表读写操作已经成功。如果这里报错,先核对脚本是否完整复制,包括最后一行 BASH,不要继续执行不完整的文件。脚本由 bash 显式调用,无须修改可执行权限。
这里的 grep -F -x 查找完全等于 feature=on 的一整行。它返回 0 表示找到,返回 1 表示没有找到;后者在本任务中意味着功能未开启,不应被当作脚本故障。其他非 0 状态则按读取或命令错误处理。进入 else 后立即保存 $? 很重要:执行了下一条命令,原先的退出状态就会被覆盖。

set -e 针对未处理的非 0 状态,set -u 提醒使用未设置的变量,pipefail 则让管道中非末尾命令的失败有机会体现在整个管道的状态中。grep 位于 if 条件内,Bash 不会仅因它返回 1 就按 set -e 退出,所以脚本可以按返回值分类。ERR 陷阱负责报告未被分支处理、最终向外传播的错误;fatal 则给输入缺失等已识别错误提供明确消息。陷阱不是替代每个命令判断的通用捕获器,例如变量未设置的诊断不能依赖它兜底。
第二步:运行成功路径,核对输出与退出状态
bash "$workdir/check.sh" "$workdir"
run_status=$?
printf 'exit=%s\n' "$run_status"
cat "$workdir/report.txt"
预期示例为 created: .../report.txt、exit=0,报告内容为 feature=on 和 lines=2。wc -l 统计的是换行符数量;准备步骤使用 printf 写入两行且各有换行,因此这里是 2。终端显示的具体临时路径以本机创建结果为准,并非固定输出。
报告写入放在普通执行路径上,重定向失败会使子 shell 返回非 0,进而使脚本失败。lines=$(wc -l < "$input") 也将单条 wc 命令的失败反映为赋值失败。不要写成 local lines=$(wc -l < "$input"):某些声明写法会用 local 自身的成功状态掩盖右侧命令的失败。命令替换内若包含多条命令,还需单独设计其失败传播,不能仅凭外层 set -e 推断全部安全。
第三步:验证可忽略返回值与必须终止的错误
新建另一个演示子目录,让配置文件存在但不含目标行:
mkdir -- "$workdir/off"
printf '%s\n' 'feature=off' > "$workdir/off/settings.txt"
bash "$workdir/check.sh" "$workdir/off"
printf 'exit=%s\n' "$?"
cat "$workdir/off/report.txt"
预期退出状态为 0,报告显示 feature=off、lines=1。这不表示 grep 找到了内容,而是脚本明确接受了 grep 的状态 1,并将检查结果转换为可供后续步骤使用的正常报告。
再检查缺失输入。命令放在 if 条件里,是为了让演示用终端即使启用了更严格的退出设置,也能打印被测脚本的状态:
mkdir -- "$workdir/missing"
if bash "$workdir/check.sh" "$workdir/missing"; then
printf 'unexpected success\n'
else
printf 'exit=%s\n' "$?"
fi
预期出现 input is not a regular file,退出状态为 66,且没有生成报告。66 是本示例为输入文件缺失选用的状态,不是 Bash 自动赋予该错误的编号。若文件在存在性检查之后被移走,后续 grep 也可能返回错误:存在性检查不能代替命令本身的状态检查。
要直接观察“无匹配”和“命令出错”不是一回事,可以在临时目录中对不存在的文件执行一次单独检查:
if grep -F -x 'feature=on' "$workdir/not-found.txt" > /dev/null; then
printf 'found\n'
else
printf 'grep exit=%s\n' "$?"
fi
预期 grep 在标准错误输出中提示文件不存在,通常返回 2,而不是表示无匹配的 1。因此不能把 grep 的所有非 0 状态都改写成成功。在需要严格区分读取错误的检查中,本例使用匹配输出重定向到 /dev/null,而没有使用 grep -q;部分 grep 实现即使遇到错误,也可能在已找到匹配时让 -q 返回 0。
最后复核禁止覆盖:
if bash "$workdir/check.sh" "$workdir"; then
printf 'unexpected overwrite\n'
else
printf 'rerun exit=%s\n' "$?"
fi
cat "$workdir/report.txt"
预期第二次运行失败,并保留首次生成的报告。set -C 对现有报告启用禁止覆盖;终端可能同时显示 Bash 的重定向错误和脚本的 unexpected failure 提示。若生产任务需要重复执行,应另行设计版本化文件名、临时文件及原子替换策略,不要为消除报错就直接去掉覆盖保护。
出现异常时,先定位是哪一层返回了非零
可按下面的顺序判断,而不是在命令后统一追加 || true:
| 场景 | 返回状态的含义 | 本例处理方式 |
|---|---|---|
grep 找到目标行 | 0,检查命中 | 写入 feature=on |
grep 未找到目标行 | 1,输入有效但未命中 | 写入 feature=off,脚本仍成功 |
grep 无法正常读取文件 | 通常为 2,命令出错 | 报错并终止,不生成成功报告 |
| 输入文件缺失 | 本例显式指定 66 | 报错并终止 |
| 报告已存在或无法写入 | 写入命令返回非 0 | 保留原报告,脚本失败 |
类似地,diff 常用 0 表示相同、1 表示不同、2 表示出错;判断“不同”是否可接受,要看脚本目的,不能把所有命令的状态 1 都套用 grep 的规则。对于确实允许失败的命令,优先写成 if command; then ... else status=$?; ... fi,明确限定可接受的状态和后续动作。
还要留意 set -e 的边界:if、while 条件,以及 &&、||、! 等上下文具有例外;没有 pipefail 时,管道默认主要取最后一个命令的状态。例如以下命令分别说明管道默认规则与启用后的变化,不会修改演示文件:
bash -c 'false | cat > /dev/null; printf "default pipeline=%s\n" "$?"'
bash -c 'set -o pipefail; false | cat > /dev/null; status=$?; printf "pipefail pipeline=%s\n" "$status"'
预期分别显示 0 和 1。pipefail 使失败可见,但不会替脚本决定该失败是否可以忽略;仍需结合命令语义编写分支。
验收与回滚检查项
- 验收语法:
bash -n "$workdir/check.sh"返回 0;首次正常运行返回 0,报告内容与输入相符。 - 验收分类:无匹配输入生成
feature=off;缺失输入返回非 0 且不生成报告;重复运行不会覆盖已有报告。 - 验收范围:确认
workdir指向本次创建的专用临时目录,演示过程没有修改该目录之外的文件。示例输出仅说明预期结果,实际状态以本机命令返回值为准。 - 回滚前检查:用以下命令列出待删除对象,确认只有本次脚本、输入文件、子目录和报告;若变量已丢失或目录中出现其他文件,先人工核对,不要直接执行删除。
printf 'WORKDIR=%s\n' "${workdir:-unset}"
if [[ -n ${workdir:-} && -d $workdir && ! -L $workdir ]]; then
find "$workdir" -maxdepth 2 -print
fi
确认路径与清单后,只删除本次专用目录。下方条件用于降低变量为空或误指向其他位置时的误删风险;它不能代替对清单的人工核对。删除会一并移除演示报告,如需保留应先另行备份。
if [[ -n ${workdir:-} && -d $workdir && ! -L $workdir && $workdir == "${TMPDIR:-/tmp}"/bash-error-demo.* ]]; then
rm -r -- "$workdir"
else
printf '路径未通过检查,未执行删除\n' >&2
fi
回滚后再检查 [[ ! -e $workdir ]] 是否成立;若删除报权限或文件占用等错误,先查看剩余内容,不要扩大删除路径。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/8431.html



