Webman单元测试需手动配置骨架：phpunit.xml必须置于根目录并设bootstrap指向tests/bootstrap.php（内含support/bootstrap.php引入），测试类放tests/unit/下、命名含Test后缀、方法以test开头，Mock须用Mockery::mock并绑定到容器，数据库测试推荐事务回滚或SQLite内存库。
Webman项目里写单元测试，不是照搬 Laravel 或 Symfony 的那一套——它没有内置的测试命令、不自动加载 tests 目录、也不默认配好 phpunit.xml。你得手动搭骨架，否则 vendor/bin/phpunit 一跑就报 Class 'Tests\TestCase' not found 或直接跳过所有测试。
如何让 PHPUnit 正确加载 Webman 的类和配置
核心问题不是“怎么写断言”，而是“PHPUnit 根本找不到你的业务类”。Webman 的自动加载靠 support/bootstrap.php 启动框架服务，但 PHPUnit 默认只走 vendor/autoload.php，跳过了这层初始化。
- 必须在
tests/bootstrap.php中显式引入：require __DIR__ . '/../support/bootstrap.php'; -
phpunit.xml的bootstrap属性要指向这个文件，不能只写vendor/autoload.php - 如果测试中要用到容器（比如
container()->get()），确保bootstrap.php已执行Webman\Container::getInstance()初始化 - 避免在
bootstrap.php里启动 HTTP 服务或监听端口——单元测试不需要 Worker 启动，加了反而会卡住进程
测试类命名与目录结构怎么才不被 PHPUnit 忽略
PHPUnit 默认只扫描 Test 结尾的类，且方法名必须以 test 开头或带 @test 注解。但 Webman 项目常把测试放在 tests/unit/ 下，若没配对，phpunit 会静默跳过整个目录。
- 目录结构建议固定为：
tests/unit/YourServiceTest.php，而非tests/YourServiceTest.php -
phpunit.xml中<directory>tests/unit</directory>路径必须精确匹配，大小写敏感 - 类名必须含
Test后缀，如UserServiceTest；类内方法用testCanCreateUser或/** @test */ public function creates_user_with_valid_data() - 不要在测试类里用
extends TestCase以外的父类——Webman 没提供Tests\TestCase，别抄 Laravel 那套
依赖外部服务时，Mock 为什么总失效
Webman 里大量使用依赖注入（如 Db、Redis、Http\Client），但直接 new 实例或从容器取对象会导致测试变慢、不稳定，甚至污染数据库。Mock 失效常见于三类场景：
立即学习“PHP免费学习笔记（深入）”；
- 没用
Mockery::mock()替换容器绑定：必须调用container()->bind('redis', $mockRedis)，而不是只创建 mock 对象 - 被测类里硬编码
new Redis()：这种写法无法被替换，得先重构为构造函数注入或 setter 注入 - Mock 方法名拼错或参数类型不匹配：
$mock->shouldReceive('get')->with('key')->andReturn('value')中，get和'key'必须与实际调用完全一致（包括是否传引用、是否为 null） - 忘记在
tearDown()里调用Mockery::close()，导致后续测试收到残留 mock 行为
数据库测试该用内存 SQLite 还是事务回滚
Webman 没集成 Laravel 的 DatabaseTransactions Trait，所以不能直接用 RefreshDatabase。硬连真实 MySQL 会拖慢测试速度、产生脏数据；全用 SQLite 内存库又可能掩盖 SQL 兼容性问题。
- 推荐方案：测试前用
Db::connection()->beginTransaction()，tearDown()中rollback()——前提是所有操作都在同一个连接内 - 如果用了多连接（如读写分离），事务回滚无效，此时必须切到 SQLite 内存库：
DB_CONNECTION=sqlite DB_DATABASE=:memory: - 注意
sqlite:memory:是每个连接独立的，多个测试并行运行时不会冲突，但需在每个测试里重新建表（用Schema::create()） - 别在
setUp()里执行迁移 —— Webman 的 migration 命令不支持内存驱动，应手写建表 SQL 或用Db::statement()
最难绷的是：Webman 单元测试的“单元”边界比想象中窄。一个控制器方法看似简单，但背后可能串了 Service → Repository → Db → Redis → HttpClient，不一层层拆干净，测试就只是集成测试的伪装。真正有效的单元测试，往往要写三倍于业务代码的 Mock 和断言逻辑——这不是浪费时间，是把隐式依赖显性化的过程。
