Docker构建失败但Gitlab-CI报成功（假阳性）问题如何解决

数据老陈

2026-10-2

问题原因

该问题是Windows环境下GitLab Runner Shell执行器和Docker CLI的常见兼容性问题，核心原因有两个：

旧版本Docker Desktop for Windows存在bug，docker build命令执行失败时，无法向父Windows Shell正确返回非0退出码，始终返回0，导致GitLab Runner判定命令执行成功。
Windows系统下PowerShell/CMD的默认错误处理逻辑和Linux Bash不同：GitLab Runner默认仅捕获Shell内置命令的错误，对于docker这类外部可执行文件的非0退出码，不会主动触发任务失败。你测试时用到的$?是Bash专属的退出码变量，在PowerShell中对应获取外部命令退出码的变量是$LASTEXITCODE，这也是你打印返回码结果为true的原因。

解决方案

你可以按优先级选择以下任意一种方案修复：

方案1（最便捷无需改环境）：在Pipeline中显式捕获docker命令退出码，非0时主动退出
如果你用PowerShell作为Runner的默认执行Shell，修改配置如下：

build:
  stage: build
  script:
    - docker build --no-cache -t $CI_REGISTRY/dockerfile:$CONTAINER_LABEL .
    - if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }

如果你用CMD作为默认执行Shell，修改配置如下：

build:
  stage: build
  script:
    - docker build --no-cache -t $CI_REGISTRY/dockerfile:$CONTAINER_LABEL .
    - if %errorlevel% neq 0 exit /b %errorlevel%

方案2：升级Docker Desktop到最新稳定版，新版本已经修复了Windows平台下Docker CLI退出码透传的bug。
方案3：修改GitLab Runner的config.toml配置，开启Shell执行器的严格错误检查，对应Runner配置段添加如下内容：
```
[[runners]]
  # 其他原有配置保留
  shell = "powershell"
  [runners.shell.powershell]
    error_action_preference = "STOP"
    pwsh = false # 如果你使用PowerShell Core则改为true
```
配置完成后重启GitLab Runner服务即可生效，后续外部命令返回非0退出码时会自动标记任务失败。