GitLab CI流水线中自定义Docker镜像内grep命令执行失败排查

问题根源 #

GitLab CI默认会将命令的非零退出码判定为步骤失败。当grep "error" typos.txt没有匹配到任何内容时，grep会返回退出码1，直接触发流水线终止——这就是你遇到的核心问题。本地运行正常是因为要么确实有错误匹配（grep返回0），要么本地shell没有严格校验命令退出码。

解决方案 #

方案1：忽略grep的非零退出码 #

在grep命令后追加|| true，强制让命令返回0退出码，避免流水线中断：

script:
  - echo "Checking typos..."
  - typos > typos.txt
  - echo "Typos check complete."
  - grep "error" typos.txt > grep.txt || true  # 忽略无匹配时的非零退出码
  - echo "Typos found in repo -> "
  - wc -l < grep.txt

方案2：用grep直接统计数量（更简洁） #

不需要生成中间文件，用grep -c直接统计匹配行数，同时处理无匹配的情况：

script:
  - echo "Checking typos..."
  - ERROR_COUNT=$(typos | grep -c "error" || echo 0)
  - echo "Typos found in repo -> $ERROR_COUNT"

这里|| echo 0保证当grep返回1（无匹配）时，变量会被赋值为0，不会触发流水线失败。

方案3：用typos原生输出统计（最可靠） #

typos支持输出JSON格式，用jq解析统计错误数，避免依赖grep的文本匹配：

1. 先在Docker镜像中安装jq：

FROM rust:slim-bullseye
RUN cargo install typos-cli && apt-get update && apt-get install -y --no-install-recommends jq
WORKDIR /app
ENTRYPOINT ["tail", "-f", "/dev/null"]

2. 更新CI脚本：

script:
  - echo "Checking typos..."
  - ERROR_COUNT=$(typos --format json | jq '.errors | length')
  - echo "Typos found in repo -> $ERROR_COUNT"

这种方式完全基于工具的结构化输出，不会因为文本格式变化导致统计错误，稳定性更高。

额外建议 #

• 你的Docker镜像里的ENTRYPOINT ["tail", "-f", "/dev/null"]在CI中被覆盖为entrypoint: [""]，这没问题，但可以考虑直接在Dockerfile里去掉这个ENTRYPOINT，避免CI中额外配置。
• 可以在CI步骤中添加set -e（默认开启）来明确命令失败终止的行为，同时针对性处理允许失败的命令。

内容的提问来源于stack exchange，提问作者Marco Rodrigues