Linux bash严格模式下处理空匹配和管道错误

Linux 上的 Bash 脚本打开 set -euo pipefail 后，最容易误判的不是“严格模式失效”，而是把预期的空匹配当成故障，或只看到了管道最后一个命令的退出码。处理原则很简单：预期可能失败的命令放进明确的条件上下文，管道结束后立即保存 PIPESTATUS，真正的故障再交给 -e 中止。

官方地址：https://www.gnu.org/software/bash/

先把严格模式看成三道边界

-e 让返回非零的命令列表倾向于终止脚本，-u 把未定义变量当成错误，pipefail 则让管道不再只听最后一段。它们保护的是不同资产：流程完整性、输入完整性和数据链路完整性。

GNU Bash 手册特别列出：失败命令若位于 if 测试、while/until 条件、&& 或 || 列表的特定位置，-e 不会直接退出。这个例外不是漏洞，而是给脚本表达“我已经处理这个失败”的语法边界。

把空匹配放进条件上下文

grep 没找到文本时返回 1，找到了返回 0，参数或文件错误通常返回 2。若把它单独写在严格模式下，空匹配可能提前结束脚本；若它本来就是判断条件，就直接让它成为 if 的测试命令：

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

log_file="/var/log/app.log"

# 0 表示找到，1 表示没有匹配；只有 2 等真正错误才中止。
if grep -q -- "timeout" "$log_file"; then
  echo "发现 timeout 记录"
else
  status=$?
  if [[ "$status" -eq 1 ]]; then
    echo "本轮没有 timeout，继续执行"
  else
    printf '读取日志失败，exit=%s\\n' "$status" >&2
    exit "$status"
  fi
fi

这里的关键是先保留 $?，再做下一次判断；任何后续命令都会覆盖它。对文件列表也采用同样思路：先让命令返回数组，再用数组长度表达“空结果”：

# nullglob 让无匹配时得到空数组，而不是保留字面量模式。
shopt -s nullglob
files=(/srv/incoming/*.json)
if ((${#files[@]} == 0)); then
  echo "没有待处理 JSON，结束本轮"
else
  printf '待处理文件数：%s\\n' "${#files[@]}"
fi

不要为了绕过一次空匹配就整段执行 set +e。临时关闭会扩大未处理错误的范围，尤其在函数和子 shell 组合时更难审计。

用 PIPESTATUS 定位管道失败

没有 pipefail 时，producer | filter | consumer 的整体状态通常只取最后一段；打开后，整体状态会反映最右侧的非零状态，但它仍然不会告诉你是哪一个模块出了问题。Bash 提供的 PIPESTATUS 是命令刚结束时的数组快照。

set -euo pipefail

# 管道命令结束后立即复制状态，避免 printf 或其他命令覆盖快照。
set +e
producer | filter | consumer
pipeline_status=("${PIPESTATUS[@]}")
set -e

if ((${pipeline_status[0]} != 0 || ${pipeline_status[1]} != 0 || ${pipeline_status[2]} != 0)); then
  printf '管道失败 producer=%s filter=%s consumer=%s\\n' \\
    "${pipeline_status[0]}" "${pipeline_status[1]}" "${pipeline_status[2]}" >&2
  exit 1
fi

这段代码只在“允许管道失败、随后统一判断”的小范围里暂时关闭 -e。如果管道失败本身一定是致命错误，可以保留严格模式，让 pipefail 直接触发退出；需要多段状态时，再把命令放进受控函数或条件结构中。

把错误处理变成可复查的清单

生产脚本至少记录命令用途、输入范围、各段退出码和是否属于预期分支。不要只记录“脚本失败”，否则值班时无法区分无数据、权限错误和上游损坏。

• 空匹配是否是正常业务结果？是就放进 if 或显式检查的条件命令。
• 管道是否启用了 pipefail？需要定位时是否在第一条后续命令前保存 PIPESTATUS？
• 是否在读取 $? 前执行了 echo、赋值命令或日志函数？
• 是否为输入文件、变量展开和权限失败保留非零退出码，而不是全部吞掉？

相关问题

grep 没有匹配时一定应该让脚本失败吗？

不一定。若“没有匹配”代表本轮没有任务，应作为条件分支；若它意味着配置缺失，则应把返回 1 转成带上下文的失败。

pipefail 能直接告诉我哪一段命令坏了吗？

不能。它只改变管道整体退出状态；需要定位时读取并立即保存 PIPESTATUS，再按下标记录每一段。

能不能全局关闭 set -e？

可以，但通常不值得。优先缩小例外范围，让脚本在其他未处理错误上继续保持快速失败。