PHPUnit 10升级后assert配置类型断言错误求助

错误含义 #

这个断言失败意味着PHPUnit内部Configuration类的静态单例属性self::$instance未指向合法的Configuration实例。该断言是PHPUnit内部的校验逻辑，说明你直接调用TestSuite::fromClassName时，PHPUnit的配置上下文没有被正确初始化。

根本原因 #

PHPUnit 10对测试套件创建逻辑做了重大重构：

• PHPUnit 9中TestSuite::fromClassName可独立调用，内部会自动完成配置初始化
• PHPUnit 10中该方法依赖已初始化的Configuration实例，手动直接调用时这个实例未被正确创建，触发了内部断言校验失败

解决方案 #

停止直接调用PHPUnit\Framework\TestSuite::fromClassName，改用PHPUnit 10提供的TestSuiteFactory配合配置实例创建测试套件：

use PHPUnit\Runner\TestSuiteFactory;
use PHPUnit\Configuration\DefaultConfiguration;

// 创建默认配置实例
$configuration = DefaultConfiguration::create();
// 基于配置获取测试套件工厂
$testSuiteFactory = TestSuiteFactory::fromConfiguration($configuration);

foreach ($testClasses as $name) {
    $suite = $testSuiteFactory->createFromClassName($name);
}

如果是自定义测试运行场景，建议遵循PHPUnit 10的扩展规范，通过官方入口初始化测试环境，避免直接操作底层类导致的上下文缺失问题。

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