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 失效常见于三类场景：

没用 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 和断言逻辑——这不是浪费时间，是把隐式依赖显性化的过程。

Tags: Webman PHP单元测试编写

分享到：