如何在Laravel测试中模拟AWS Cognito登录验证流程？

针对你的需求，有现成工具可以直接使用，也可以手动实现轻量的模拟逻辑，两种方案的实现细节如下：

一、现成工具方案 #

• 如果你使用aws/aws-sdk-php-laravel官方扩展包，它内置了AWS服务的Mock客户端，可以直接模拟Cognito的认证响应，不需要发起真实网络请求到AWS服务端。
• 如果你用第三方Cognito认证包（比如tymon/jwt-auth适配Cognito的方案），大部分成熟的扩展包都自带测试辅助方法，支持直接模拟已登录用户，和原生actingAs的使用体验一致。

二、手动实现方案（推荐，可控性更高） #

不需要额外引入依赖，只需要对现有代码做少量调整即可适配测试需求：

步骤1：给认证中间件增加测试兼容逻辑 #

在你实现的Cognito认证中间件中，增加测试环境的判断分支，测试环境下跳过AWS端的JWT校验，直接读取自定义请求头的用户信息完成登录：

public function handle(Request $request, Closure $next)
{
    // 仅测试环境走模拟登录逻辑
    if (app()->environment('testing')) {
        $testUserId = $request->header('X-Test-Cognito-User-Id');
        if ($testUserId && $user = \App\Models\User::find($testUserId)) {
            auth()->setUser($user);
            return $next($request);
        }
        abort(401, 'Unauthorized');
    }

    // 非测试环境正常走原有Cognito JWT校验逻辑
    $jwt = $request->bearerToken();
    // 原有校验逻辑：从Cognito拉取JWKS校验JWT合法性、解析用户信息...
    return $next($request);
}

步骤2：封装测试辅助方法 #

在项目的测试基类tests/TestCase.php中封装自定义的模拟登录方法，替换原有actingAs：

/**
 * 模拟Cognito登录用户
 */
protected function actingAsCognito(\App\Models\User $user)
{
    return $this->withHeader('X-Test-Cognito-User-Id', $user->id);
}

步骤3：测试用例示例 #

调整后的测试用例写法和原有逻辑几乎一致，不需要大幅修改现有测试：

public function test_get_user_profile_returns_correct_data()
{
    $user = \App\Models\User::factory()->create([
        'email' => 'test@example.com'
    ]);

    $response = $this->actingAsCognito($user)
        ->getJson('/api/user/profile');

    $response->assertStatus(200)
        ->assertJson([
            'id' => $user->id,
            'email' => 'test@example.com'
        ]);
}

三、需要完整校验JWT的场景实现 #

如果你需要在测试中也走完整的JWT校验逻辑，又不想请求AWS服务，可以按照如下方案实现：

1. 本地生成RSA密钥对，私钥用于生成测试用JWT，公钥配置到JWT校验组件中，替换原有Cognito的JWKS公钥地址
2. 生成JWT时保持和Cognito返回的字段完全一致，包括iss、sub、cognito:groups、cognito:username等业务需要的自定义字段，保证业务逻辑可以正常解析。

注意事项 #

• 测试环境和生产环境一定要做好隔离，建议在中间件中增加强制校验：如果生产环境触发了测试分支的模拟登录逻辑，直接抛出异常避免安全问题
• 如果你的业务逻辑依赖Cognito返回的自定义属性，需要在模拟登录时把对应属性挂载到用户对象上，保证业务逻辑的测试覆盖完整

内容的提问来源于stack exchange，提问作者user3384126