Gitlab-runner任务执行成功但PHPUnit返回错误状态0问题排查

问题根因&修复方案 #

1. 先修复gitlab-ci.yml的语法错误 #

你当前的配置重复声明了stages字段，第二次声明为空，会覆盖第一次的有效阶段定义，导致阶段逻辑失效。修正后的基础配置如下：

stages:
  - test
  - deploy 
  - .post

test_job:
  stage: test
  script:
    # 先开启bash严格模式，避免命令错误被忽略
    - set -euo pipefail
    # 显式指定配置文件路径，确保修改的phpunit配置生效
    - phpunit --configuration ./phpunit.xml

2. 排查PHPUnit返回错误退出码的问题 #

首先在Runner执行环境手动执行失败的测试用例，执行完成后立刻运行echo $?查看退出码：

• 如果退出码是非0：说明问题出在CI配置的脚本执行逻辑，加了上面的set -euo pipefail即可解决
• 如果退出码仍然是0：按以下顺序排查PHPUnit侧问题：
  • 确认你修改的stopOnFailure=true的配置文件是PHPUnit实际加载的，执行命令时加上--configuration参数显式指定路径
  • 检查Bootstrap_tests.php引导文件，是否存在注册shutdown函数、强制修改进程退出码、关闭错误报告的逻辑
  • 检查测试用例代码，是否存在大量@错误抑制符、异常捕获后未抛出的逻辑
  • 升级PHPUnit到对应大版本的最新稳定版，老版本存在测试失败仍返回0的已知bug

3. 临时兜底方案 #

如果短时间无法定位PHPUnit返回0的根因，可以在CI脚本中加输出校验强制失败：

test_job:
  stage: test
  script:
    - set -euo pipefail
    - phpunit | tee phpunit_run.log
    # 匹配输出中的失败/错误关键字，匹配到就强制返回非0退出码
    - ! grep -qE "(FAILURES!|ERRORS!|Exception:|Fatal error:)" phpunit_run.log

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