
本文详解如何在 Laravel 中正确编写单元测试,验证未通过邮箱验证的已登录用户访问受保护路由时,是否被自动登出并重定向至登录页(如 route('home')),涵盖工厂配置、断言组合及关键注意事项。
本文详解如何在 laravel 中正确编写单元测试,验证未通过邮箱验证的已登录用户访问受保护路由时,是否被自动登出并重定向至登录页(如 `route('home')`),涵盖工厂配置、断言组合及关键注意事项。
在 Laravel 应用中,保障未验证邮箱用户的访问安全是常见需求:当用户完成注册但尚未点击邮件验证链接时,即便其仍处于登录态,也不应允许访问需认证且仅对已验证用户开放的页面(如首页或仪表盘)。你的控制器逻辑已正确实现该策略——检查 email_verified_at 字段,若为空则调用 auth()->logout() 并重定向至登录页。而测试该行为的关键,在于精准模拟未验证用户状态,并验证双重效果:HTTP 重定向 + 认证态清除。
以下是推荐的单元测试写法(基于 Laravel 9+ 和 Pest/PHPUnit):
public function test_an_unverified_user_is_logged_out_and_redirected()
{
// 创建一个 email_verified_at 为 null 的用户(即未验证)
$user = User::factory()->create([
'email_verified_at' => null,
]);
// 模拟该用户发起 GET 请求到受保护路由
$response = $this->actingAs($user)
->get(route('landing.worldwide'));
// 断言响应为 302 重定向,目标为登录页
$response->assertRedirect(route('home'));
// 关键!验证用户当前已完全登出(session 清空、guard 无活跃用户)
$this->assertGuest();
}✅ 为什么原测试失败?
你原先的测试先手动调用了Auth::logout(),导致$user在actingAs()之前已被登出,actingAs($user)实际未生效;后续请求以游客身份发出,根本不会进入控制器的auth()->user()->email_verified_at判断分支,自然无法触发预期逻辑。
? 进阶建议:
- 若项目使用 Laravel 自带的
UserFactory,可直接使用内置的unverified()状态方法(Laravel 8.5+ 默认支持):$user = User::factory()->unverified()->create();
- 在
tests/Feature/AuthenticationTest.php等语义化命名的测试类中组织此类用例,便于后期维护。 - 补充边界测试:例如验证已验证用户能正常访问
landing.worldwide页面(assertOk()+assertViewIs()),形成正向/负向完整覆盖。
⚠️ 注意事项:
- 确保
route('home')已在routes/web.php中正确定义(通常指向/login或/); - 测试运行环境需启用 session(Laravel 默认 PHPUnit 配置已满足);
- 不要依赖
Auth::check()或auth()->user()在测试断言中手动判断——$this->assertGuest()是 Laravel 提供的语义清晰、底层可靠的断言,它会校验当前 guard 是否无认证用户,且 session 中无有效凭证。
通过上述结构化测试,你不仅能验证重定向行为,更能确保安全退出机制真正生效——这是防止未验证用户“越权滞留”的关键防线。

















