GitLab CI中Shell脚本执行失败无错误输出的解决方法咨询

我之前也踩过这个坑——本地跑脚本能正常输出错误细节，放到GitLab CI里就只给个干巴巴的ERROR: Job failed: exit code 1，完全摸不着头脑。核心问题其实是GitLab CI默认会启用set -e规则（遇到错误立即终止脚本），你的原脚本结构会导致错误信息还没来得及输出，脚本就被强制终止了。

问题根源分析 #

先看你原来的代码：

output="$( (cd "$FOLDER"; eval "$@") 2>&1 )"
if [ "$output" ]; then
    echo -e "$output\n"
fi

当cd切换目录失败，或者eval执行的命令出错时，$(...)的退出码会变成非零。因为GitLab CI的set -e机制，脚本会在执行完赋值语句后直接退出，根本走不到后面的echo步骤——错误信息确实被捕获到了output变量里，但永远没机会被打印出来。而本地运行时通常没有开启set -e，所以脚本会继续执行echo，自然能看到错误。

修改后的可行脚本 #

把脚本改成下面这样，就能确保错误信息被强制输出，同时保留原命令的退出状态：

# 执行目标命令，捕获所有输出（包括错误信息）
output="$(cd "$FOLDER" && eval "$@" 2>&1)"
# 保存原命令的退出码
exit_code=$?

# 强制输出捕获到的所有内容，不管是否为空
echo -e "$output\n"

# 以原命令的退出码结束脚本，让GitLab CI正确识别任务状态
exit $exit_code

关键改进点 #

1. 优化执行逻辑：把(cd "$FOLDER"; eval "$@")改成cd "$FOLDER" && eval "$@"，这样如果cd失败，就不会执行后续的eval，避免触发无意义的额外错误。
2. 保留退出状态：用exit_code=$?保存原命令的退出码，确保脚本最终的退出状态和原命令完全一致，GitLab CI能准确判断任务成败。
3. 强制输出内容：去掉if [ "$output" ]的判断，不管输出是否为空都打印——哪怕命令失败但没有输出，也能明确看到脚本执行过这一步。
4. 显式退出脚本：最后用exit $exit_code让脚本的退出码和原命令绑定，既保证GitLab CI能识别失败，又提前输出了所有错误细节。

这样修改后，不管命令成功还是失败，所有输出（包括错误）都会被打印出来，你再也不用对着exit code 1瞎猜问题出在哪了。

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