ThinkPHP版本迁移后的测试用例编写指南_自动化回归测试-ThinkPHP-PHP中文网

tp6 彻底移除 think\testing\testcase，改用 phpunit\framework\testcase；需手动初始化应用、用 http::get/post 模拟请求，响应断言用 getcode()；测试库须独立并手动迁移；facade 需容器先注册。

thinkphp版本迁移后的测试用例编写指南_自动化回归测试

TP6 彻底移除了 TP5.x 的 think\testing\TestCase，改用 PHPUnit 原生方式组织测试，不再提供框架封装的基类。直接沿用旧写法会触发 Class 'think\testing\TestCase' not found。

实操建议：

删除所有继承自 think\testing\TestCase 的测试类，改用 PHPUnit\Framework\TestCase
手动加载应用环境：在 setUp() 中调用 App::beforeStart() 或显式初始化容器（如需模拟 HTTP 请求，推荐用 think\facade\Http 的 invoke）
数据库测试前务必清空/重置测试库，TP6 不再自动隔离测试数据库连接
注意 phpunit.xml 中的 bootstrap 路径要指向 TP6 的 tests/bootstrap.php（若你按标准结构生成过），否则 Facade 和服务无法自动注册

旧版 $this->get()、$this->post() 等快捷方法已失效，TP6 不再注入这些方法到测试类中。强行调用会报 Call to undefined method。

实操建议：

用 think\facade\Http 构造请求：Http::withHeaders(['Accept' => 'application/json'])->post('/api/user', ['name' => 'test'])
响应对象是 think\Response 实例，断言状态码用 $response->getCode()，不要用 $response->getStatusCode()（那是 PSR-7 接口，TP6 响应不实现它）
JSON 响应体需先调用 $response->getContent() 再 json_decode()，直接 $response->json() 不存在
若需完整模拟中间件链（如鉴权、日志），别跳过 App::make('http')，否则中间件不执行

TP6 默认不为每个测试用例重置数据库，phpunit --colors tests/ 连续跑多次，很可能因上一个测试残留数据导致下一个失败。

实操建议：

禁用生产配置中的 'deploy' => true（若开启，迁移命令会跳过 SQL 执行）
在 setUp() 中执行 Artisan::call('migrate:refresh', ['--seed' => true])，但必须确保测试数据库是独立库（如 database_test），不能和开发库共用
使用 think\migration\Migrator 时，注意 setConnection() 必须早于 run()，否则仍操作默认连接
SQLite 内存数据库（:memory:）虽快，但 TP6 的迁移器对它支持不稳定，容易报 SQLSTATE[HY000]: General error，建议用独立 MySQL 测试库

TP6 的 Facade 是延迟绑定的，若测试中直接写 Cache::get('key') 却没触发容器注册，就会报 Call to undefined method think\Facade\Cache::get()。

实操建议：

确保 tests/bootstrap.php 中已执行 require __DIR__.'/../vendor/autoload.php'; 和 App::initCommon();
在测试方法里，先调用 App::getContainer()->get('cache') 一次，强制 Facade 初始化；或直接用 app('cache') 替代 Cache::get()
避免在 setUpBeforeClass() 中大量使用 Facade——该方法运行时容器可能尚未完全就绪
检查 config/app.php 中的 'providers' 是否包含 think\Service\ServiceProvider，漏掉会导致部分 Facade 绑定失败