GitLab Runner捕获批处理错误及文件匹配失败的方法咨询

针对你遇到的两个核心问题——批处理脚本错误未触发Job失败、制品文件匹配警告未被识别，我给你分步骤梳理解决方案：

一、让GitLab Runner识别批处理脚本的Syntax Error并终止Job #

GitLab Runner在Windows环境下默认不会自动捕获批处理脚本的退出码，这就是为什么即使build.cmd/buildm.cmd出现Syntax Error，Job依然显示成功的原因。你可以通过以下两种方式修复：

1. 修改批处理脚本，强制返回错误码 #

在你的build.cmd和buildm.cmd末尾添加以下代码，确保脚本执行失败时返回非0退出码：

@echo off
REM 你的原有脚本内容
...
REM 检查上一条命令的执行结果，如果失败则退出并返回错误码
if %errorlevel% neq 0 exit /b %errorlevel%

如果脚本中有多个关键命令，也可以在每个命令后添加类似的错误检查，确保任何一步出错都会传递错误码。

2. 在.gitlab-ci.yml的script中强制检查批处理执行结果 #

如果不想修改批处理脚本，也可以直接在CI配置里添加错误检查步骤：

build:
  stage: build
  script:
    - build.cmd
    - if %errorlevel% neq 0 exit /b %errorlevel%
  # 其他配置保持不变
build_master:
  stage: build
  script:
    - buildm.cmd
    - if %errorlevel% neq 0 exit /b %errorlevel%
  # 其他配置保持不变

这样只要批处理执行出错，Runner就会捕获到非0退出码，直接标记Job失败。

二、让制品文件匹配警告触发Job失败 #

当前你看到的WARNING: Ticket/Ticket_111b: no matching files是因为Runner找不到paths里配置的%CI_COMMIT_REF_NAME%路径对应的文件，但默认情况下警告不会导致Job失败。要让这种情况触发失败，可以做以下调整：

1. 在build阶段添加文件存在检查 #

在build阶段的script末尾添加文件验证步骤，确保生成的制品路径存在：

build:
  stage: build
  script:
    - build.cmd
    - if %errorlevel% neq 0 exit /b %errorlevel%
    - if not exist "%CI_COMMIT_REF_NAME%" exit /b 1
  artifacts:
    expire_in: 1 week
    name: "%CI_COMMIT_REF_NAME%"
    paths:
      - "%CI_COMMIT_REF_NAME%"
  # 其他配置保持不变

同样的，build_master阶段也添加这个检查步骤。这样如果目标路径不存在，Job会直接失败，而不是只输出警告。

2. 全局强制制品文件匹配（可选） #

如果你希望所有Runner执行的Job，只要制品路径无匹配文件就触发失败，可以修改Runner的config.toml配置文件，在[[runners]]节点下添加环境变量：

[[runners]]
  # 其他原有配置
  environment = ["GITITLAB_RUNNER_ARTIFACTS_REQUIRE_EXISTING_FILES=true"]

这个配置会让Runner在制品路径无匹配文件时直接标记Job失败，无需在每个Job里单独添加检查。

三、优化后的完整.gitlab-ci.yml示例 #

结合上面的修改，你的配置可以更新为：

before_script:
  - xcopy /y /s "C:/Bauen" "%CI_PROJECT_DIR%"
stages:
  - build
  - deploy
build:
  stage: build
  script:
    - build.cmd
    - if %errorlevel% neq 0 exit /b %errorlevel%
    - if not exist "%CI_COMMIT_REF_NAME%" exit /b 1
  artifacts:
    expire_in: 1 week
    name: "%CI_COMMIT_REF_NAME%"
    paths:
      - "%CI_COMMIT_REF_NAME%"
  only:
    - tags
  except:
    - master
build_master:
  stage: build
  script:
    - buildm.cmd
    - if %errorlevel% neq 0 exit /b %errorlevel%
    - if not exist "%CI_COMMIT_REF_NAME%" exit /b 1
  artifacts:
    expire_in: 1 week
    name: "%CI_COMMIT_REF_NAME%"
    paths:
      - "%CI_COMMIT_REF_NAME%"
  only:
    - master
deploy:
  stage: deploy
  script:
    - ./upload.cmd
    - if %errorlevel% neq 0 exit /b %errorlevel%
  dependencies:
    - build_master
  only:
    - master

这样调整后，无论是批处理脚本的语法错误，还是制品文件找不到的情况，都会直接触发Job失败，而不是默默忽略或者只显示警告。

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