Webman单元测试跑不起来主因是tests/bootstrap.php未正确初始化框架上下文，必须显式加载Config、执行bootstrap类start方法、设置时区，且跳过$app->run()；控制器测试需用Request::create()构造请求并手动注入mock依赖，严禁发真实HTTP请求或直连数据库。
Webman 单元测试跑不起来，八成是 bootstrap.php 没配对
直接运行 phpunit 报 RuntimeException: App not boot，说明框架上下文根本没加载。Webman 不像 Laravel 那样自带测试引导，必须手动补全容器、配置和基础服务初始化。
在 tests/bootstrap.php 里不能只写 require_once __DIR__ . '/../vendor/autoload.php';，否则 config()、app()->container 全是空的。要显式加载：
-
Webman\Config::load(__DIR__ . '/../config/')—— 否则 route.php、container.php 读不到 - 遍历
config('bootstrap', [])并执行每个类的::start()—— 否则中间件、事件监听器不会注册 - 手动设置时区：
date_default_timezone_set(config('app.timezone', 'Asia/Shanghai'))—— 否则Carbon或日志时间错乱 - 跳过
$app->run()和$app->bootstrap()—— 这俩会触发路由注册和 HTTP 生命周期，单元测试里不需要
测控制器别 new，用 Request::create() + 手动注入依赖
裸 new UserController() 然后调 show()，必然报 Call to a member function input() on null —— 因为 $this->request 是 null，且构造函数里依赖的 UserService 也没被容器解析。
正确做法是绕过路由层，直触方法逻辑：
- 用
Webman\Http\Request::create('/user/123', 'GET')构造请求对象，它能模拟完整请求上下文 - 若控制器构造函数需要服务类，用
$this->createMock(UserService::class)创建 mock，再传入：new UserController($mockService) - 不要调
Route::dispatch()或发真实 HTTP 请求（如file_get_contents('http://localhost/...')）—— 这属于集成测试，慢且不可控 - 测试方法命名用业务语义，比如
testShowUserReturns404WhenUserNotFound()，别叫testShow()
数据库、Redis、HTTP 客户端这些强依赖，必须 Mock
一跑测试就卡住、报 DatabaseConnectionException 或超时，说明你没隔离外部依赖。单元测试的目标是验证逻辑，不是验证 MySQL 是否连得上。
Webman 2.2.0版本强化了 TCP/UDP 服务支持，优化路由组管理，并增强异步任务处理能力。结合协程与连接池技术，Webman 能轻松应对高并发场景，适用于网站、接口服务、即时通讯、物联网及游戏开发，兼具高性能、灵活扩展与稳定可靠，是多场景 PHP 服务开发的理想选择。
哪些该 mock，怎么 mock：
- 数据库操作：mock
UserModel::class或封装的UserRepository，用$mock->method('find')->willReturn($user) - Redis：mock
Webman\Redis::class或你封装的缓存服务，避免测试环境连生产 Redis - 第三方 HTTP 调用：mock 底层
GuzzleHttp\Client或你封装的ApiClient，防止测试因网络抖动失败 - 不要用 SQLite 内存库“假装”单元测试 —— 它仍是真实 DB，违反隔离原则，且 SQL 方言差异可能掩盖问题
集成测试才该启动 Webman 服务，但别用 phpunit 直启
想测「真实请求打进来，中间件+路由+控制器整条链路是否通」，这才是集成测试。但它不能和单元测试混在同一套 phpunit.xml 里跑，否则速度拖垮、失败难定位。
推荐做法：
- 单独建
tests/integration/目录，用phpunit --testsuite integration隔离执行 - 集成测试里用
Webman\Test\HttpTestCase（如果项目已封装）或自己写轻量级 HTTP client，发真实请求到本地127.0.0.1:8787 - 启动服务用
webman start -d或 Docker，**别在测试代码里调exec('php webman start')** —— 容易端口冲突、进程残留 - 集成测试数据用工厂模式生成，每次跑完清库（如
DB::table('users')->truncate()），避免用例间污染
真正麻烦的是中间件顺序和全局配置覆盖 —— 比如测试登录中间件时，config/middleware.php 里一堆中间件全跑一遍，很可能因为日志中间件写文件失败而中断。这时候得在测试配置里显式覆盖，只留必要项。
