GitHub Actions中Bash脚本grep返回exit 1问题求助

问题原因 #

GitHub Actions环境中，Bash默认可能开启了set -e（脚本也可能显式设置），该选项会让脚本在任何命令返回非0退出码时直接终止。而grep在未找到匹配内容时会返回exit status 1，这属于正常的“无匹配”情况，但会触发脚本中断，导致后续逻辑无法执行——这就是你的脚本本地正常、CI环境失败的核心原因。

修复方案 #

针对串联的grep命令，你可以通过以下几种方式处理退出码：

1. 强制grep返回0（最简单的临时修复） #

在每个grep命令后追加|| true，让即使无匹配时也返回0，避免脚本终止：

# 原命令（会触发exit 1）
mismatched=$(grep -r "@version" src/ | grep -v "$MAVEN_VERSION")

# 修改后
mismatched=$(grep -r "@version" src/ || true | grep -v "$MAVEN_VERSION" || true)

2. 区分“无匹配”和真错误（更严谨的处理） #

如果需要排查grep的真实错误（比如权限问题、路径不存在），可以单独捕获退出码，只忽略“无匹配”的情况：

# 捕获第一个grep的退出码
grep -r "@version" src/ > version_lines.txt
if [ $? -ne 0 ] && [ $? -ne 1 ]; then
  echo "grep执行出错"
  exit 1
fi

# 捕获第二个grep的退出码
grep -v "$MAVEN_VERSION" version_lines.txt > mismatched.txt
if [ $? -ne 0 ] && [ $? -ne 1 ]; then
  echo "过滤版本时出错"
  exit 1
fi

mismatched=$(cat mismatched.txt)

3. 关闭set -e再恢复（如果脚本依赖该选项） #

如果脚本开头用了set -e，可以在grep执行前后临时关闭该选项：

set +e # 关闭立即退出
mismatched=$(grep -r "@version" src/ | grep -v "$MAVEN_VERSION")
EXIT_CODE=$?
set -e # 恢复立即退出

# 这里可以根据EXIT_CODE处理：比如EXIT_CODE为1表示无匹配，属于正常情况
if [ $EXIT_CODE -ne 0 ] && [ $EXIT_CODE -ne 1 ]; then
  exit $EXIT_CODE
fi

额外注意事项 #

• 检查你的GitHub Actions工作流文件，确保没有在run指令中额外开启严格模式（比如run: set -e; ./script.sh）
• 确认CI环境中src目录下的文件结构与本地一致，避免因路径问题导致grep完全找不到内容

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