假设部署脚本要从构建日志和验证日志里找 status=FAILED。验证日志没生成,标准输出也是空的;如果脚本只看有没有匹配行,仍会打出“未发现失败”。GNU grep 能分清正常未匹配和打不开文件。这里用两份临时日志复现,再看加上 -q 后,为什么连退出码也可能误导你。
在本例中,使用 -F 按字面量查找,不用 -v 反选。GNU grep 正常选中至少一行时退出 0,没有选中且未出错时退出 1,遇到错误时通常退出 2;-q 命中时有下节的例外。别拿标准输出是否为空去还原这几个状态。一份完全正常的日志可以没有命中,丢失的文件也可以没有输出,而错误详情通常在标准错误里。
退出状态 | 这批输入发生了什么 | 脚本该做什么 |
|---|---|---|
| 有匹配;此处指未使用 | 按匹配结果走故障复核分支 |
| 没有匹配,命令未遇到错误 | 记为“这批输入未命中指定文本” |
| GNU grep 出错,例如打不开文件 | 保留诊断,标记本次检查不完整 |
其他实现出错时可能返回大于 2 的状态码,所以分支留一个“其他”。这张表说的是 grep 确实运行后的退出状态。Shell 如果没能打开重定向的目标,可能自己返回 1,这时 grep 根本没启动。输出文件需要重定向时,先单独打开并检查成功,再运行 grep,不要用这张表解释 Shell 的重定向错误。
-q 并不是把结果重定向到 /dev/null有些地方确实只关心“能不能找到一条”。比如你已经拿到一份完整的本地样本,现在只想知道某个字面量在不在里面,用 -q 很合适。但在“同时检查两份都应该存在的日志”这个场景,-q 会改变检查语义:找到一条就立即退出 0。把有命中的文件放前面,后面的缺失文件可能根本没处理;把缺失文件放前面,标准错误可以先报出文件不存在,之后只要命中,退出状态仍是 0。
删掉 -q 会怎样?下面的实验里,普通搜索先打印第一份文件的匹配行,随后因为第二份缺失退出 2。这行匹配是真实的,却只能代表已经读过的输入。想要的是“检查这批文件”,不是“有一行就行”,就不能拿部分结果跑后续动作。

图中两列是两种用法,不是先后步骤。-q 没有命中时仍能区分 1 和 2;它的例外是命中时返回 0,即使先前遇到了错误。>/dev/null 只丢弃标准输出,不改变 grep 检查输入的方式。
else 里第一件事:存下退出码用 if grep …; then 接住正常命中,进入 else 就先存 rc=$?,再用 case 区分 1 和其他状态。先打日志再读 $?,拿到的就可能是 printf 的结果。也不要把条件改成 if ! grep … 后再照搬 $?:! 已经反转了退出状态。下方脚本的 check 函数保留了这个顺序,即使用 set -e,也能捕获预期的 1 和 2。
需要命中行时,把标准输出先放进这次检查的临时结果,等命令返回后再决定是否交给下一步。只需要状态时,把标准输出重定向到 /dev/null,保留标准错误。-s 压掉的是不存在或不可读等诊断,它不会把错误变成“没有匹配”。
把代码保存为 grep-demo.sh,用 bash grep-demo.sh 执行。实验用 mktemp 建两个普通文本文件,第三个文件故意不建;trap 只清理本次临时目录。这里用 Linux 上的 GNU grep 3.1 核对退出码、匹配行和标准错误;没有访问部署机器,也不读现有日志。-F 把 status=FAILED 当字面文本,-H 强制给输出加文件名前缀,因此可以准确检查部分输出来自哪个文件。
#!/usr/bin/env bash
set -eu
export LC_ALL=C
work=$(mktemp -d)
trap 'rm -rf -- "$work"' EXIT
cd -- "$work"
printf '%s\n' 'stage=build status=OK' > build.log
printf '%s\n' 'stage=verify status=FAILED' > 'verify step.log'
check() {
local label=$1 want=$2 out=$3 err=$4 rc
shift 4
if "$@" > actual.out 2> actual.err; then
rc=0
else
rc=$?
fi
if [[ $rc != "$want" || $(<actual.out) != "$out" ]]; then
printf 'FAIL %s: unexpected status/output (rc=%s)\n' "$label" "$rc" >&2
exit 1
fi
case $err in
none) [[ ! -s actual.err ]] ;;
missing) [[ $(<actual.err) == *'absent.log'*'No such file'* ]] ;;
regex) [[ -s actual.err ]] ;;
esac || { printf 'FAIL %s: unexpected stderr\n' "$label" >&2; exit 1; }
printf 'PASS %s\n' "$label"
}
needle='status=FAILED'
hit='verify step.log:stage=verify status=FAILED'
check hit 0 "$hit" none grep -FH -- "$needle" build.log 'verify step.log'
check miss 1 '' none grep -F -- "$needle" build.log
check missing 2 '' missing grep -F -- "$needle" absent.log
check miss-and-error 2 '' missing grep -F -- "$needle" build.log absent.log
check plain-partial 2 "$hit" missing grep -FH -- "$needle" 'verify step.log' absent.log
check quiet-first 0 '' none grep -Fq -- "$needle" 'verify step.log' absent.log
check quiet-second 0 '' missing grep -Fq -- "$needle" absent.log 'verify step.log'
check quiet-no-hit 2 '' missing grep -Fq -- "$needle" absent.log build.log
check suppress-error 2 '' none grep -Fs -- "$needle" absent.log
check bad-regex 2 '' regex grep -E -- '[' build.log
# 只丢弃标准输出,不启用 -q。输入故障仍应传给调用方。
if grep -F -- "$needle" 'verify step.log' absent.log >/dev/null 2>actual.err; then
printf 'FAIL discard-stdout: unexpected success\n' >&2
exit 1
else
rc=$?
[[ $rc == 2 && $(<actual.err) == *'absent.log'* ]] || exit 1
fi
printf 'PASS discard-stdout\n'看最后几组比看单个 PASS 更有用:quiet-first 和 quiet-second 都退出 0,但只有后者写了缺文件诊断;quiet-no-hit 没命中,就没有这个掩盖错误状态的例外。discard-stdout 用同一批输入丢弃输出,仍看到状态 2。这几组放在一起,才能分清“屏幕没东西”和“命令没出错”。
如果每次部署都应产出构建日志和验证日志,把两条预期路径都传给 grep。不要只搜“实际存在”的文件,否则缺了哪份日志,grep 无从得知。路径可能带空格,可以用 Bash 数组分别保存,再按 "${logs[@]}" 展开。这个例子预期有两份日志;如果清单从上游读取,拿到空清单应直接报输入错误。不给文件参数时,GNU grep 通常会读标准输入,并不是检查了零份日志。
最后,检查日志不是检查部署成功。固定文本能漏掉改了大小写或字段名的事件,也无法识别日志外的失败。发布验收仍要看部署进程的退出状态、目标版本和应用健康检查。如果日志输入本身出错,独立告警;别让它落到“检查通过”的同一个结果里。
参考:GNU grep 退出状态;GNU grep 输出控制。
本文使用 AI 辅助写作及配图。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。