PHPUnit未正确安装、配置文件缺失或测试目录结构不规范会导致ThinkPHP单元测试失败；需安装^10.5版本、配置phpunit.xml、构建标准tests/目录结构、通过容器获取模型实例、用mockRequest模拟HTTP请求。
如果您尝试在ThinkPHP项目中运行单元测试，但测试用例无法识别或执行失败，则可能是由于PHPUnit未正确安装、配置文件缺失或测试目录结构不符合规范。以下是解决此问题的步骤：
一、安装PHPUnit并验证版本兼容性
ThinkPHP 8 基于 PHP 8.1+，必须使用 PHPUnit ^10.5 版本；若误装 v9 或更低版本，将导致类加载失败或断言方法不可用。安装过程需在项目根目录执行，且必须声明为开发依赖。
1、运行命令安装指定版本：composer require --dev phpunit/phpunit ^10.5
2、验证安装是否成功：./vendor/bin/phpunit --version
立即学习“PHP免费学习笔记（深入）”；
3、检查PHP扩展是否启用：dom、json、pcre、reflection、spl、tokenizer 缺一不可，否则PHPUnit启动即报错
二、创建并配置phpunit.xml文件
phpunit.xml 是 PHPUnit 的核心配置文件，必须置于项目根目录；若路径错误或缺少 bootstrap 指向，会导致 tests/ 目录下所有测试类无法自动加载。
1、在项目根目录新建文件：phpunit.xml
2、写入以下最小可用配置（注意缩进与标签闭合）：<?xml version="1.0" encoding="UTF-8"?><phpunit bootstrap="vendor/autoload.php" colors="true"><testsuites><testsuite name="Application Test Suite"><directory suffix="Test.php">./tests</directory></testsuite></testsuites></phpunit>
3、确认 bootstrap="vendor/autoload.php" 存在且路径准确，否则 Container::get()、App::init() 等框架核心类将无法解析
三、构建标准测试目录结构
tests/ 目录必须与 app/、public/ 同级，不可嵌套于 app/ 内；PHPUnit 默认从当前工作目录扫描 ./tests，若路径错误则提示 “No tests found”。
1、在项目根目录创建目录：mkdir tests
2、在 tests/ 下创建基类文件：tests/TestCase.php
3、该文件内容必须继承 think\testing\TestCase 并实现 createApplication() 方法：return include __DIR__ . '/../thinkphp/start.php';
4、测试用例文件须以 Test.php 结尾，例如 UserServiceTest.php，且类名严格匹配文件名
四、编写可执行的Model测试用例
直接 new Model 实例会跳过容器初始化，导致 $this->db 为 null，调用 save() 或 where() 时抛出 Call to a member function query() on null 异常。
1、在 tests/ 下新建 UserModelTest.php
2、类定义需继承 tests\TestCase：class UserModelTest extends TestCase
3、测试方法以 test 开头，例如：public function testShouldFindUserById()
4、获取模型实例必须通过容器：$user = $this->app->make(\app\model\User::class);
5、执行查询前确保数据库连接可用，必要时在 setUp() 中调用 $this->app->initialize();
五、模拟HTTP请求测试控制器
直接实例化控制器并调用 action 方法会绕过中间件、路由参数绑定和请求对象注入，导致 $this->request 为 null，且无法覆盖真实请求链路。
1、使用内置 Mocker 构造请求：$this->mockRequest('GET', '/user/profile', ['id' => 5]);
2、发起模拟请求并捕获响应：$response = $this->get('/user/profile?id=5');
3、验证响应状态码：$this->assertEquals(200, $response->getStatusCode());
4、验证JSON结构（若返回JSON）：$this->assertJson($response->getContent());
5、每个测试末尾添加清理：\think\facade\Request::clear();
