Jenkins中Bash脚本报错未返回状态码1导致任务不失败如何解决

根因分析 #

• 首先可以确定你当前运行的是VERBOSE_MODE开启的if分支：因为你能看到git的错误输出，而else分支所有git命令都加了&>/dev/null会吞掉所有标准输出和错误输出。
• 判断逻辑失效的核心原因是你要判断的git错误退出码被后续其他命令的退出码覆盖了：你提到最终判断逻辑是[[ 0 -ne 0 ]]，说明判断时$?的值是0，而$?永远返回的是紧邻的上一条命令的退出码，说明在拼写错误的git命令执行完成后、判断$?之前，插入了其他执行成功的命令（比如echo打印、日志输出等），这类命令的退出码永远是0，覆盖了git命令的非0错误退出码，导致判断条件不触发，不会执行exit 1。
• 附加原因：默认shell没有开启错误终止模式，如果你的脚本后续还有其他执行成功的命令，整个脚本的最终退出码是最后一条命令的0值，Jenkins默认以脚本的最终退出码判断任务状态，退出码为0就会标记任务成功。

修复方案 #

1. 先修正git命令的拼写错误：把拼写错误的git pulll/git pullllll改为正确的git pull
2. 脚本开头添加shell严格模式配置，不需要手动逐行判断退出码，只要命令执行失败就会直接终止脚本，返回非0退出码：

set -euo pipefail

3. 如果你需要保留手动判断退出码的逻辑，要先把目标命令的退出码保存到变量中，避免被后续命令覆盖：

# 错误写法：中间插入echo会覆盖git命令的退出码
git pull
echo "pull命令执行完成"
if [[ $? -ne 0 ]]; then
  echo "拉取代码失败"
  exit 1
fi

# 正确写法：先保存退出码再做其他操作
git pull
pull_exit_code=$?
echo "pull命令执行完成"
if [[ ${pull_exit_code} -ne 0 ]]; then
  echo "拉取代码失败"
  exit 1
fi

4. 验证Jenkins构建配置，确保是执行完整的脚本文件，不是拆分的多条独立shell命令，拆分配置的情况下单条命令失败不会终止整个构建流程。

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