因为 CodeIgniter 4 测试环境默认不自动注入请求对象，ControllerTestCase 不构造完整 HTTP 上下文，直接 new 控制器会导致 $this->request 和 $this->response 为 null；正确做法是用 withRequest() 显式传入 Services::request() 创建的模拟请求实例。
测试控制器时为什么 $this->request 总是 null？
因为 CodeIgniter 4 的测试环境默认不自动注入请求对象，ControllerTestCase 不会帮你构造完整 HTTP 上下文。直接 new 控制器或用 new TestController() 调用方法，$this->request 和 $this->response 都是未初始化的 null。
正确做法是用 TestResponse 配合 withRequest() 显式传入模拟请求：
$request = Services::request();
$request->setMethod('POST');
$request->setBody(json_encode(['name' => 'test']));
$result = $this->withRequest($request)
->controller(TestController::class)
->execute('index');
$this->assertTrue($result->isOK());
- 别手动 new 控制器——它依赖服务容器和上下文，脱离框架运行会缺失依赖
-
Services::request()返回的是测试专用的TestRequest实例，不是生产环境的IncomingRequest - 如果控制器里用了
$this->request->getGet()或getPost()，必须提前用setGet()/setPost()设置数据，不能只塞 raw body
如何 mock 服务类（比如 UserModel）并注入到控制器？
CodeIgniter 4.7.2 的控制器依赖通过服务容器解析，所以不能靠构造函数参数 mock，得替换容器里的实例。
在测试方法开头用 Services::injectMock() 替换目标服务：
$mockModel = $this->createMock(UserModel::class);
$mockModel->method('find')->willReturn(['id' => 1, 'name' => 'Alice']);
Services::injectMock('userModel', $mockModel);
$result = $this->controller(TestController::class)
->execute('show');
-
Services::injectMock()第一个参数是服务名（通常是小驼峰，如'userModel'），不是类名全路径 - 如果模型是通过
model('UserModel')获取的，确保该调用走的是服务容器——默认开启，但若手动 new 过模型，mock 就失效 - mock 后执行控制器方法，内部调用
$this->userModel->find(1)就会命中你设的返回值
execute() 返回 TestResponse，但怎么断言 JSON 响应内容？
TestResponse 不提供 getJSON() 方法，直接 $result->getBody() 拿到的是原始字符串，需手动 json_decode；且要注意响应头是否设为 application/json，否则 CI 可能不触发 JSON 自动解析逻辑。
$result = $this->controller(ApiController::class)
->execute('list');
$this->assertEquals(200, $result->getStatusCode());
$this->assertEquals('application/json', $result->getHeaderLine('Content-Type'));
$body = json_decode($result->getBody(), true);
$this->assertArrayHasKey('data', $body);
$this->assertCount(3, $body['data']);
- 务必检查
Content-Type头，CI 4.7.2 在非 JSON 头下不会自动把 body 当 JSON 解析，getBody()就是纯字符串 - 控制器里用
return $this->response->setJSON([...])才会设置正确 header；用echo json_encode(...)不行 -
json_decode(..., true)要加true参数，否则返回 stdClass，assertArrayHasKey会失败
测试带路由参数的控制器方法（如 /users/123）怎么传 ID？
CI 4 的路由参数不会自动绑定到方法参数，而是通过 $this->request->getUri()->getSegment() 或 $this->uri->getSegment() 获取，测试时得让 URI 包含对应路径段。
用 withURI() 构造带路径的请求：
$uri = new \CodeIgniter\HTTP\URI();
$uri->setPath('users/123');
$request = Services::request();
$request->setUri($uri);
$result = $this->withRequest($request)
->controller(UsersController::class)
->execute('view');
- 别试图用
->execute('view', [123])传参——execute()的第二个参数只用于模拟方法调用的参数，但 CI 控制器方法不接收路由参数作为函数参数（除非你手动改了路由映射规则） - 如果控制器里用了
$this->uri->getSegment(2)，确保setPath('users/123')后 segment 2 确实是'123' - 更稳妥的方式是在测试前调用
$this->routes->add('users/(:num)', 'UsersController::view/$1');，再用withURI()模拟匹配后的路由结果
$this->request 就是 null，$this->userModel 就是真数据库连接，$this->uri 就拿不到 segment。动手前先想清楚：你到底在测哪一层？是逻辑分支，还是框架集成？ 
