在 CodeIgniter4 单元测试中，多次调用 post() 时 MockSession 的验证错误未自动清理，导致后续测试误读残留错误；需通过 resetServices 和显式 mockSession 初始化来确保会话隔离。
在 codeigniter4 单元测试中，多次调用 `post()` 时 mocksession 的验证错误未自动清理，导致后续测试误读残留错误；需通过 `resetservices` 和显式 `mocksession` 初始化来确保会话隔离。
当使用 CodeIgniter4 内置测试工具（如 FeatureTestTrait）编写多个表单验证测试时，一个常见陷阱是：首次测试触发的验证错误（如 errors 或 _ci_validation_errors）会滞留在 MockSession 中，影响后续测试的断言结果。这是因为 CI4 的 MockSession 默认不自动重置其内部状态，即使启用了 resetServices，若未显式初始化 MockSession 实例，旧的会话数据（尤其是验证错误和 $_SESSION['errors']）仍会被复用。
✅ 正确解决方案：组合使用 resetServices 与 mockSession
CI4 提供了预置的测试辅助方法，应在测试类中通过 $setUpMethods 显式声明：
protected $setUpMethods = [
'resetServices', // 重置所有服务实例（包括 Validator、Session 等）
'mockSession', // 创建并注册全新的 MockSession 实例
];resetServices 确保每次测试前重建服务容器，而 mockSession 则强制替换 Session 服务为干净的 MockSession 对象——它内部使用 ArrayHandler 存储数据，且每次调用 mockSession() 都会清空其 $_data 属性，从而彻底隔离各测试用例的会话状态。
⚠️ 注意：不要手动操作 $_SESSION = [] 或调用 $session->destroy() —— 在 MockSession 下这些方法无效，且可能破坏测试框架对会话生命周期的控制。
✅ 测试方法设计原则
- 每个测试方法仅发起一次 HTTP 请求（如一个 ->post()），避免在单个测试中多次提交表单。否则，MockSession 的状态会在同一测试内累积，导致断言失败。
- 移除手动 session 清理逻辑：删除 $_SESSION = []; 等冗余代码，交由 mockSession 自动处理。
- 确保路由路径准确：示例中控制器方法名为 question() 和 attemptQuestion()，但测试调用的是 "contact" 路由（对应 contact/index）。请确认实际路由映射是否一致（例如 contact/question vs contact），否则 assertRedirectTo() 将失败。
✅ 完整修正后的测试类示例
<?php
namespace CodeIgniter;
use CodeIgniter\Test\CIUnitTestCase;
use CodeIgniter\Test\FilterTestTrait;
use CodeIgniter\Test\FeatureTestTrait;
class ContactPostTest extends CIUnitTestCase
{
use FilterTestTrait, FeatureTestTrait;
protected $setUpMethods = [
'resetServices',
'mockSession',
];
public function testQuestionError()
{
$params = [
'name' => str_repeat('x', 31), // 超长姓名
'email' => 'invalid-email', // 格式错误
'message' => '', // 空消息
csrf_token() => csrf_hash(),
];
$expectedErrors = [
'name' => 'Please limit to the first 30 characters in your name',
'email' => 'Your email is invalid',
'message' => 'Message is required',
];
$this->checkQuestion($params, $expectedErrors);
}
public function testQuestionSuccess()
{
$params = [
'name' => 'Joe Tester',
'email' => 'joe@example.com',
'message' => 'This is a valid message.',
csrf_token() => csrf_hash(),
];
$this->checkQuestion($params, false, lang('Base.messageSent'));
}
private function checkQuestion($parameters, $errors = false, $message = false)
{
$result = $this->post('contact', $parameters); // 注意：确保路由匹配实际控制器方法
$result->assertOK();
$result->assertRedirect();
$result->assertRedirectTo(site_url('contact')); // 或 site_url('contact/question')
if ($errors !== false) {
$result->assertSessionHas('errors', $errors);
}
if ($message !== false) {
$result->assertSessionHas('message', $message);
}
}
}? 验证机制说明
- assertSessionHas('errors', $array) 内部检查 MockSession::$_data['errors'] 是否存在且内容匹配；
- mockSession() 方法在 CIUnitTestCase 中定义，会执行 $this->session = new MockSession(new ArrayHandler()); 并注入容器，确保无历史污染；
- resetServices 同时重置 Validation 服务，避免上一测试中 Validator 的错误缓存干扰当前验证。
✅ 总结
| 问题根源 | 解决方案 |
|---|---|
| MockSession 状态跨测试复用 | 启用 mockSession + resetServices 组合初始化 |
| 手动清空 $_SESSION 无效 | 删除所有手动 session 操作，信任测试框架的隔离机制 |
| 多次 post() 导致状态叠加 | 每个测试方法只执行一次请求，保持原子性 |
遵循以上模式，即可稳定运行多组表单验证测试，彻底规避“旧错误残留”问题，提升 CI4 测试可靠性与可维护性。
