首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >GNU grep 没输出就算没匹配?部署脚本要分清退出码 1 和 2

GNU grep 没输出就算没匹配?部署脚本要分清退出码 1 和 2

原创
作者头像
逻界软件科技工作室
发布于 2026-11-20 10:42:32
发布于 2026-11-20 10:42:32
170
举报

假设部署脚本要从构建日志和验证日志里找 status=FAILED。验证日志没生成,标准输出也是空的;如果脚本只看有没有匹配行,仍会打出“未发现失败”。GNU grep 能分清正常未匹配和打不开文件。这里用两份临时日志复现,再看加上 -q 后,为什么连退出码也可能误导你。

先判断命令,再判断日志

在本例中,使用 -F 按字面量查找,不用 -v 反选。GNU grep 正常选中至少一行时退出 0,没有选中且未出错时退出 1,遇到错误时通常退出 2;-q 命中时有下节的例外。别拿标准输出是否为空去还原这几个状态。一份完全正常的日志可以没有命中,丢失的文件也可以没有输出,而错误详情通常在标准错误里。

退出状态

这批输入发生了什么

脚本该做什么

0

有匹配;此处指未使用 -q 且未报错

按匹配结果走故障复核分支

1

没有匹配,命令未遇到错误

记为“这批输入未命中指定文本”

2

GNU grep 出错,例如打不开文件

保留诊断,标记本次检查不完整

其他实现出错时可能返回大于 2 的状态码,所以分支留一个“其他”。这张表说的是 grep 确实运行后的退出状态。Shell 如果没能打开重定向的目标,可能自己返回 1,这时 grep 根本没启动。输出文件需要重定向时,先单独打开并检查成功,再运行 grep,不要用这张表解释 Shell 的重定向错误。

-q 并不是把结果重定向到 /dev/null

有些地方确实只关心“能不能找到一条”。比如你已经拿到一份完整的本地样本,现在只想知道某个字面量在不在里面,用 -q 很合适。但在“同时检查两份都应该存在的日志”这个场景,-q 会改变检查语义:找到一条就立即退出 0。把有命中的文件放前面,后面的缺失文件可能根本没处理;把缺失文件放前面,标准错误可以先报出文件不存在,之后只要命中,退出状态仍是 0。

删掉 -q 会怎样?下面的实验里,普通搜索先打印第一份文件的匹配行,随后因为第二份缺失退出 2。这行匹配是真实的,却只能代表已经读过的输入。想要的是“检查这批文件”,不是“有一行就行”,就不能拿部分结果跑后续动作。

GNU grep 静默匹配与退出状态
GNU grep 静默匹配与退出状态

图中两列是两种用法,不是先后步骤。-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 压掉的是不存在或不可读等诊断,它不会把错误变成“没有匹配”。

一次跑完 11 个本地对照

把代码保存为 grep-demo.sh,用 bash grep-demo.sh 执行。实验用 mktemp 建两个普通文本文件,第三个文件故意不建;trap 只清理本次临时目录。这里用 Linux 上的 GNU grep 3.1 核对退出码、匹配行和标准错误;没有访问部署机器,也不读现有日志。-F 把 status=FAILED 当字面文本,-H 强制给输出加文件名前缀,因此可以准确检查部分输出来自哪个文件。

代码语言:bash
复制
#!/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 删除。

目录
  • 先判断命令,再判断日志
  • -q 并不是把结果重定向到 /dev/null
  • else 里第一件事:存下退出码
  • 一次跑完 11 个本地对照
  • 合并到部署脚本前,先核对输入清单
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档