GitLab CI 任务失败原因分析与 PHPUnit 警告/弃用提示处理指南

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。

✅ 解决方案：禁用或抑制弃用警告

推荐在项目根目录创建标准 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 准确反映真实测试结果，避免误报失败。