PHPUnit显示存在错误但未指明具体测试用例的排查求助

问题背景 #

我有一个运行在PHP 8.2 Docker容器中的Symfony 6项目，使用PHPUnit 10.5版本。执行测试时得到如下输出：

$ bin/phpunit
PHPUnit 10.5.5 by Sebastian Bergmann and contributors.

Runtime:       PHP 8.2.12
Configuration: /var/www/phpunit.xml

...............................................................  63 / 222 ( 28%)
............................................................... 126 / 222 ( 56%)
.EEE........................................................... 189 / 222 ( 85%)
.................................                               222 / 222 (100%)

Time: 00:20.429, Memory: 120.00 MB

Auth Data Extractor (App\Tests\UnitTests\Security\AuthDataExtractor)
 ✔ Get credentials admin 1 house
 ✔ Get credentials edit 2 house
[....]

Witness Service (App\Tests\UnitTests\Domain\WitnessService)
 ✔ Create
 ✔ Create no witness
 ✔ Update no previous witnesses
 ✔ Update replace previous witnesses
 ✔ Get collection

ERRORS!
Tests: 222, Assertions: 1866, Errors: 3.

所有测试结果均显示为通过（绿色），但EEE标记和汇总信息显示存在3个错误，却无法看到具体出错的测试方法。此前出现错误时，PHPUnit会指明出错的方法；按文件夹运行测试时错误情况不稳定，单文件运行则无错误。已执行composer update、重建容器，但问题仍存在。

当前phpunit.xml配置如下：

<?xml version="1.0" encoding="UTF-8"?>
<!-- https://phpunit.readthedocs.io/en/latest/configuration.html -->
<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/10.4/phpunit.xsd"
         colors="true"
         bootstrap="tests/bootstrap.php"
         cacheResult="false"
         executionOrder="default"
         testdox="true"
         displayDetailsOnTestsThatTriggerErrors="true"
         cacheDirectory=".phpunit.cache">
    <coverage/>
    <php>
        <ini name="error_reporting" value="-1"/>
        <server name="APP_ENV" value="test" force="true"/>
        <server name="SHELL_VERBOSITY" value="-1"/>
        <server name="KERNEL_CLASS" value="App\Kernel"/>
        <server name="SYMFONY_PHPUNIT_REMOVE" value=""/>
        <!--env name="SYMFONY_DEPRECATIONS_HELPER" value="weak" /-->
        <!-- ###+ nelmio/cors-bundle ### -->
        <env name="CORS_ALLOW_ORIGIN" value="^https?://(localhost|127\.0\.0\.1)(:[0-9]+)?$"/>
    </php>
    <extensions>
        <bootstrap class="DAMA\DoctrineTestBundle\PHPUnit\PHPUnitExtension" />
    </extensions>
    <testsuites>
        <testsuite name="Project Test Suite">
            <directory>tests</directory>
        </testsuite>
    </testsuites>
    <source>
        <include>
            <directory>src</directory>
        </include>
    </source>
</phpunit>

解决方法 #

• 调高输出冗余度
  执行测试时增加verbosity参数，强制显示错误详情：

  bin/phpunit -vvv
  

  或者修改phpunit.xml中的SHELL_VERBOSITY值为0或1，避免抑制输出。

• 禁用TestDox格式
  TestDox的简化输出会隐藏错误细节，临时关闭它：

  bin/phpunit --no-testdox
  

  或者直接修改phpunit.xml中的testdox="false"，恢复传统输出格式，错误会直接关联到对应的测试方法。

• 快速定位错误位置
  根据进度标记，EEE出现在第127-129个测试，用以下命令分批测试并遇到错误即停止：

  bin/phpunit --stop-on-error --limit 130
  

  也可以用--filter参数缩小范围，比如按命名空间筛选测试：

  bin/phpunit --filter 'App\\Tests\\UnitTests\\YourNamespace' --stop-on-error
  

• 排查测试隔离性问题
  单文件测试正常、批量测试出错，大概率是测试间状态污染：

  • 检查DAMA Doctrine Test Bundle是否正确配置，确保每个测试都自动回滚事务；
  • 在测试类中添加@before/@after注解，清理数据库、缓存或静态变量状态；
  • 打乱测试执行顺序验证：

    bin/phpunit --order-by random
    

    如果错误出现在不同测试上，说明存在状态泄漏。

• 查看PHP错误日志
  进入Docker容器，查看PHP错误日志（路径可能是/var/log/php8.2-fpm.log或容器stdout），PHPUnit捕获不到的致命错误会在这里留下记录，帮助定位问题根源。

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