SilverStripe 3单元测试未被测试框架检测到，请求排查

我之前在SilverStripe 3开发模块测试时也踩过这个坑，结合经验给你梳理几个关键排查点和解决方法：

1. 对齐命名空间与目录结构 #

SilverStripe 3遵循PSR规范，若你的业务类Bla.php在src/下有命名空间（比如namespace YourModule;），测试类BlaTest.php必须配置对应的命名空间，且路径要匹配：

<?php
namespace YourModule\Tests;

class BlaTest extends \SapphireTest {
    public function testCreation() {
        $this->assertEqual(...);
    }
}

注意：SilverStripe 3的SapphireTest在全局命名空间下，所以带命名空间的测试类要加\前缀引用。

2. 配置Composer自动加载规则 #

在你的模块根目录的composer.json中，必须添加测试目录的自动加载映射，放在autoload-dev节点下：

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

配置完成后运行composer dump-autoload更新自动加载文件，确保框架能找到测试类。

3. 检查文件名与类名规范 #

SilverStripe 3测试框架默认识别以Test结尾的类，且文件名必须和类名完全匹配（大小写敏感，Linux环境尤其要注意），你的BlaTest.php和BlaTest类名是符合要求的，但要确认没有大小写错误。

4. 手动注册测试类（可选） #

如果自动加载仍不生效，可以在模块的_config.php中手动注册测试类：

SapphireTest::register_test('YourModule\Tests\BlaTest');

5. 用正确的命令运行测试 #

确保使用SilverStripe官方的测试命令调用：

php framework/cli-script.php dev/tests/YourModule\Tests\BlaTest

如果配置了phpunit.xml，也可以直接指定测试文件路径：

phpunit vendor/yourmodule-name/tests/BlaTest.php

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