PowerShell环境下GitLab CI任务执行失败却显示成功如何解决

该现象是Windows环境下GitLab Runner 13.x版本使用Shell执行器调用PowerShell时的典型兼容性问题：旧版本Runner默认未开启PowerShell的错误中断配置，PowerShell本身默认不会因为单条命令执行失败、或主动调用exit返回非0码就终止执行并向外传递退出码，导致Runner始终认为任务执行成功。

• 全局配置CI任务的PowerShell错误行为：在所有job的script段开头加入两行配置，强制PowerShell遇到错误就终止执行、且正确传递外部命令的退出状态：

  $ErrorActionPreference = "Stop"
  # PowerShell 7.3及以上版本支持该配置，用于识别原生命令的非0退出码为错误
  $PSNativeCommandUseErrorActionPreference = $true
  

  修复后的gitlab-ci.yml示例：

  stages:
    - build
  
  build:
    stage: build
    script:
      - $ErrorActionPreference = "Stop"
      - $PSNativeCommandUseErrorActionPreference = $true
      - exit 1
  

• 升级GitLab Runner到14.0及以上版本：14.x之后的版本对Windows PowerShell执行器的退出码捕获逻辑做了原生修复，默认会自动识别非0退出码并标记任务失败。
• 替换Runner的执行Shell为PowerShell Core（pwsh）：相比旧版Windows PowerShell，pwsh对退出码的处理更符合Unix系shell的通用逻辑，能避免绝大多数退出码误判问题。
• 自定义脚本显式返回退出码：如果使用低于7.3版本的PowerShell，每执行完一条外部命令后，主动检查退出码并终止执行：

  # 示例：调用git命令后检查退出码
  git pull
  if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
  

• 自托管Runner全局配置：修改Runner的config.toml文件，在对应[[runners]]配置段下添加以下内容，全局注入PowerShell错误处理配置，不需要每个job单独重复配置：

  [runners.shell.powershell]
  arguments = ["-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass", "-Command", "$ErrorActionPreference='Stop'; $PSNativeCommandUseErrorActionPreference=$true; & '%CI_RUNNER_SCRIPT_PATH%'; exit $LASTEXITCODE"]
  

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