GitLab CI作业未正确传递命令退出码导致任务误判成功问题排查

问题场景 #

在.gitlab-ci.yml中为基于pnpm构建的JavaScript项目配置npm部署作业，初始配置如下：

deploy_npm:
  image: node:16.14.0-bullseye-slim
  stage: deploy
  before_script:
    - npm install -g pnpm@6.32.2
    - pnpm build
  script:
    - pnpm publish
    - echo $?

异常表现 #

• 未配置带正确鉴权token的.npmrc时，pnpm publish明确返回Unauthorized报错，但作业最终标记为成功，日志中打印的退出码为0；本地执行完全相同的命令可正常返回退出码1。
• 同类异常可复现：Vite构建触发FATAL_ERROR（如GitLab Runner内存不足进程被杀）时，作业同样会被误判为成功。
• 已尝试配置FF_ENABLE_BASH_EXIT_CODE_CHECK、FF_USE_NEW_BASH_EVAL_STRATEGY特性开关，问题未解决。

故障日志片段：

npm notice Publishing to ****************
npm ERR! code E401
npm ERR! 401 Unauthorized - PUT *******************
npm ERR! A complete log of this run can be found in:
npm ERR!     /root/.npm/_logs/2022-07-08T13_22_44_392Z-debug-0.log
$ echo $?
0
Cleaning up project directory and file based variables
00:01
Job succeeded

根因说明 #

问题是三个因素叠加导致：

1. GitLab Runner默认shell执行逻辑未开启错误中断，单条命令失败后会继续执行后续命令，整个作业的最终状态由script块最后一条执行的命令的退出码决定。
2. 你使用的pnpm@6.32.2存在已知的子进程退出码透传缺陷，内部调用npm发布子进程报错时，pnpm主进程不会透传非0退出码，自身错误返回0。
3. 配置中最后一条命令是echo $?，该命令只要执行成功就永远返回0，相当于给作业加了一层成功兜底。

可落地修复方案 #

1. 全局配置shell错误检测规则 #

在CI全局或对应作业的variables块添加配置，强制shell在命令失败时立刻终止，避免后续命令覆盖退出码：

variables:
  SHELL: /bin/bash
  BASH_ENV: "set -euo pipefail"

配置说明：

• set -e：任意命令返回非0退出码时立刻终止整个脚本执行
• set -u：引用未定义变量时直接报错退出，避免静默失败
• set -o pipefail：管道中任意命令失败，整个管道返回对应失败状态码，覆盖管道场景下的退出码丢失问题

注意：node:16.14.0-bullseye-slim镜像默认/bin/sh指向dash，对错误检测规则支持不完善，必须显式指定shell为bash。

2. 修复pnpm版本兼容问题 #

两种方案二选一即可：

• 升级pnpm版本：将pnpm@6.32.2升级到6.x最新修复版（>=6.35.1）或7.x及以上稳定版，该版本区间已修复子进程退出码透传的bug。
• 锁定版本时强制校验执行结果：如果必须使用pnpm@6.32.2，在发布命令后显式添加失败退出逻辑，同时删除多余的echo $?语句：

  script:
    - pnpm publish || exit 1
  

3. 修复构建OOM场景的退出码丢失问题 #

针对Vite构建内存不足被系统强杀导致的误判，除了上述shell配置外，给node进程显式配置内存上限，避免进程被SIGKILL信号强杀时来不及返回正确退出码：

before_script:
  - export NODE_OPTIONS="--max-old-space-size=4096"
  - npm install -g pnpm@6.32.2
  - pnpm build

如果Runner可用内存不足4G，根据实际资源下调该内存阈值，或升级Runner硬件配置。

验证方式 #

修改配置后，故意填入错误的npm鉴权token触发发布报错，作业会立刻终止并标记为失败，不会再出现打印错误但最终状态为成功的问题。

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