如何阻止AWS PHP SDK中CognitoIdentityProviderException返回500状态码

这个问题我之前在集成AWS Cognito时也碰到过，你的try/catch没生效主要有两个核心原因：一是AWS SDK抛出的是特定命名空间下的异常，不是全局的Exception；二是你没有针对性捕获Cognito的具体错误类型，导致异常漏抓后被Laravel的全局错误处理接管，直接返回500状态码。

下面给你具体的解决步骤和代码示例：

1. 明确异常类型 #

AWS SDK for PHP抛出的所有异常都继承自Aws\Exception\AwsException，而Cognito相关的错误（比如无效密码、用户不存在）会抛出更具体的Aws\CognitoIdentityProvider\Exception\CognitoIdentityProviderException，每个错误都有对应的专属错误码（比如InvalidPasswordException、UserNotFoundException）。

2. 修正命名空间与try/catch逻辑 #

首先在你的控制器顶部引入需要的异常类（如果不想引入，也可以在catch时写完整命名空间）：

use Aws\Exception\AwsException;
use Aws\CognitoIdentityProvider\Exception\CognitoIdentityProviderException;

然后修改你的代码，针对性捕获异常并处理：

try {
    $client = new CognitoIdentityProviderClient([
        'version' => 'latest',
        'region' => env('AWS_REGION', ''),
        'credentials' => [
            'key' => env('AWS_IAM_KEY', ''),
            'secret' => env('AWS_IAM_SECRET', '')
        ]
    ]);

    $result = $client->adminInitiateAuth([
        'AuthFlow' => 'ADMIN_NO_SRP_AUTH',
        'ClientId' => COGNITO_APP_CLIENT_ID,
        'UserPoolId' => COGNITO_USER_POOL_ID,
        'AuthParameters' => [
            'USERNAME' => $request->email,
            'PASSWORD' => $request->password,
        ],
    ]);

    // 登录成功后的业务逻辑
    return response()->json(['message' => '登录成功', 'data' => $result], 200);

} catch (CognitoIdentityProviderException $e) {
    // 处理Cognito专属异常
    $errorCode = $e->getAwsErrorCode();
    
    // 精准匹配无效凭证的错误场景
    if (in_array($errorCode, ['UserNotFoundException', 'InvalidPasswordException', 'NotAuthorizedException'])) {
        // 返回401状态码+友好提示，替代500错误
        return response()->json(['message' => '用户名或密码错误'], 401);
    } else {
        // 其他Cognito错误（比如客户端ID无效、用户池不存在等）
        return response()->json(['message' => '登录失败：'.$e->getMessage()], 400);
    }
} catch (AwsException $e) {
    // 处理其他AWS服务异常（比如区域配置错误、IAM权限不足等）
    return response()->json(['message' => 'AWS服务异常：'.$e->getMessage()], 500);
} catch (\Exception $e) {
    // 兜底处理其他全局异常
    return response()->json(['message' => '系统错误：'.$e->getMessage()], 500);
}

3. 关键注意点 #

• 为什么原来的catch(Exception $e)没生效？因为在Laravel控制器的命名空间下（比如App\Http\Controllers），Exception默认指的是当前命名空间下的类，而非全局的\Exception。如果不想引入异常类，你可以改成catch(\Exception $e)，但更推荐捕获具体异常来做精准处理。
• 优先捕获具体异常再捕获通用异常，这样能区分不同错误场景，给用户返回更准确的提示和HTTP状态码。
• 通过$e->getAwsErrorCode()可以拿到Cognito返回的具体错误码，方便你针对性处理不同的登录失败场景。

内容的提问来源于stack exchange，提问作者Wai Yan Hein