ThinkPHP单元测试报错主因是环境与配置问题：需用PHPUnit ^10.5（匹配PHP 8.1+），phpunit.xml置于根目录并正确配置bootstrap="vendor/autoload.php"，tests目录与app同级且含规范命名的Test.php文件，Model/Controller实例必须通过容器获取或mockRequest初始化。
ThinkPHP单元测试报错，多数不是代码逻辑问题，而是环境、配置或加载路径没对上。核心要盯住四点：PHPUnit版本是否匹配、phpunit.xml是否生效、tests目录结构是否规范、模型或控制器实例是否通过容器获取。
PHPUnit版本与PHP兼容性不匹配
ThinkPHP 8 要求 PHP 8.1+，必须使用 PHPUnit ^10.5；装了 v9 或更低版本，会出现类找不到、断言方法不存在等错误。
- 执行 composer require --dev phpunit/phpunit ^10.5 显式安装指定版本
- 运行 ./vendor/bin/phpunit --version 确认输出为 10.5.x
- 检查 php.ini 是否启用 dom、json、pcre、reflection、spl、tokenizer 扩展，缺一不可
phpunit.xml 配置失效或路径错误
文件必须放在项目根目录，且 bootstrap 必须准确指向自动加载入口，否则 TestCase 类、App、Container 都无法解析。
- 确认文件名为 phpunit.xml（不是 .dist 或其他后缀）
- bootstrap 值应为 vendor/autoload.php，若项目有自定义启动逻辑（如 thinkphp/start.php），需在 TestCase 中手动处理
- directory 标签中路径要写成 ./tests，不能是 tests/ 或 ../tests
tests 目录结构或类定义不合规
PHPUnit 默认只扫描 ./tests 下以 Test.php 结尾的文件，且类名必须严格匹配文件名，继承关系也不能错。
立即学习“PHP免费学习笔记（深入）”；
- tests/ 必须与 app/、public/ 同级，不能放在 app/ 内部
- 基类 tests/TestCase.php 必须继承 think\testing\TestCase，并实现 createApplication()
- 测试类如 UserModelTest.php，类名必须是 UserModelTest，不能少 Test 或大小写错
模型或控制器测试时 DB 或 Request 未初始化
直接 new Model() 会跳过容器绑定，导致 $this->db 为 null；控制器测试若不模拟请求，会因 Request 实例缺失而报错。
- Model 测试用 \think\Container::get(UserModel::class) 获取实例，不要 new
- 控制器测试用 \think\testing\Mocker::mockRequest() 构造请求上下文
- 数据库测试推荐 sqlite::memory:，并在 setUp 中执行建表语句（TP8 不自动迁移）
