
gitlab ci 中 phpunit 测试通过但 job 仍失败,通常是因 symfony 的弃用警告(deprecation notices)被默认视为错误;可通过配置 `symfony_deprecations_helper` 环境变量或 phpunit.xml 全局禁用或降级处理。
在 GitLab CI 中,即使所有 PHPUnit 测试用例均显示 OK(如日志中 5 tests, 16 assertions),Job 仍可能以 exit code 1 失败——这往往不是测试逻辑失败,而是 Symfony 框架或其依赖组件(如 PHPUnit 自身、PharIo、DeepCopy)触发的 弃用警告(deprecation notices)被提升为错误 所致。
默认情况下,Symfony 的 symfony/deprecation-contract 和测试工具链会将弃用提示视为“可中断的异常”,尤其在 CI 环境中启用了严格错误报告(如 error_reporting = -1)时。正如你日志所示:
Other deprecation notices (2) 1x: The "PHPUnit\DeepCopy\TypeFilter\Spl\SplDoublyLinkedListFilter" class is considered final... 1x: Method "Iterator::current()" might add "mixed" as a native return type declaration... ERROR: Job failed: exit code 1
这些警告并非来自你的业务代码,而是底层测试库兼容性问题(例如 PHPUnit 9.5 与 PHP 8.0+ 类型系统演进的临时冲突),但在 CI 中被 Symfony 的 DeprecationErrorHandler 捕获并抛出异常,最终导致整个 job 进程退出码为 1。
✅ 解决方案:禁用或抑制弃用警告
立即学习“PHP免费学习笔记(深入)”;
推荐在项目根目录创建标准 phpunit.xml 配置文件(优先级高于命令行参数),内容如下:
tests
? 注意事项:
- SYMFONY_DEPRECATIONS_HELPER=disabled 是最直接有效的方案,适用于 CI 快速验证功能正确性;
- 若需保留弃用提示用于长期维护,可改用 SYMFONY_DEPRECATIONS_HELPER=max[0](允许最多 0 条警告,即完全禁止)或 weak_vendors(仅忽略第三方包警告);
- 不建议在 .gitlab-ci.yml 中用 export SYMFONY_DEPRECATIONS_HELPER=disabled,因为 before_script 和 script 是独立 shell 会话,环境变量不自动继承;必须通过 phpunit.xml 或 --configuration 显式加载;
- 你当前脚本末尾的 exit 0 无法挽救已发生的异常退出——PHP 进程已在 phpunit 命令执行期间终止,exit 0 根本不会执行。
? 进阶建议(适配多版本 Symfony + PHP):
如你后续希望在 PHP 8.0 上分别测试 Symfony 5.4 和 6.0,可在 .gitlab-ci.yml 中利用 variables + composer create-project 实现动态环境构建,例如:
test:symfony-6.0-php8.0:
image: php:8.0
variables:
COMPOSER_ROOT_VERSION: "6.0.*"
before_script:
- curl -sS https://getcomposer.org/installer | php
- php composer.phar create-project symfony/skeleton:"$COMPOSER_ROOT_VERSION" . --no-interaction
- php composer.phar install
script:
- vendor/bin/simple-phpunit总之,弃用警告本身不会导致 PHPUnit 测试失败,但会被 Symfony 的测试错误处理器主动转为异常。正确配置 phpunit.xml 并设置 SYMFONY_DEPRECATIONS_HELPER,即可让 CI 准确反映真实测试结果,避免误报失败。











