SilverStripe 3升级至4后PHPUnit测试无法找到SapphireTest及自定义类

刚从SilverStripe 3升级到4后碰到PHPUnit测试的加载问题？我之前也踩过类似的坑，给你几个排查和解决的方向：

SilverStripe 4对PHPUnit和测试组件的版本有严格要求：

• 比如SS4.0-4.1需要PHPUnit 6，SS4.2及以上支持PHPUnit 7或8
• 检查composer.json里的silverstripe/testing和silverstripe/framework版本是否对应SS4，运行composer show silverstripe/testing可以查看当前版本
• 记得移除SS3遗留的旧依赖，比如silverstripe/sapphire这类包要删掉

SS4完全依赖Composer的PSR-4自动加载，你的自定义类找不到大概率是命名空间配置没跟上：

• 打开composer.json，确保autoload和autoload-dev节点里正确配置了你的命名空间，比如你的\My\API对应src/My/API目录，配置应该是：

"autoload": {
    "psr-4": {
        "My\\API\\": "src/My/API/"
    }
},
"autoload-dev": {
    "psr-4": {
        "My\\API\\Tests\\": "tests/My/API/"
    }
}

• 配置完一定要执行composer dump-autoload刷新自动加载缓存，这一步很多人容易忘，缓存没更新就会出现类找不到的情况

SS4的测试要严格遵循PSR-4规范：

• 测试类名必须以Test结尾，比如EntityTest对应文件EntityTest.php
• 测试文件要放在tests/目录下，和命名空间结构对应，比如\My\API\Tests\EntityTest要放在tests/My/API/EntityTest.php
• 注意SapphireTest的命名空间是SilverStripe\Dev，和SS3里的无命名空间版本不一样，所以use语句一定要写对：use SilverStripe\Dev\SapphireTest;

如果你的phpunit.xml是从SS3迁移过来的，大概率路径配置不对：

• 确保bootstrap指向SS4的正确路径：vendor/silverstripe/framework/tests/bootstrap.php，而不是SS3的sapphire/tests/bootstrap.php
• 测试套件要正确包含你的tests/目录，示例配置：

<phpunit bootstrap="vendor/silverstripe/framework/tests/bootstrap.php">
    <testsuites>
        <testsuite name="MyProject">
            <directory>./tests</directory>
        </testsuite>
    </testsuites>
</phpunit>

你提到的返回类型问题，SS4的SapphireTest::setUp()已经是返回void的，建议直接适配：

protected function setUp(): void
{
    parent::setUp();
    $this->Entity = new \My\API\Client(); // 补全你的自定义类名
}

如果暂时不想改返回类型，至少要把方法的访问级别改成protected（SS4里父类的setUp是protected，SS3可能是public），避免访问权限报错

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