部署在AWS Lambda的FastAPI后端登录返回502 Bad Gateway问题排查

• 检查Lambda执行角色权限
  • 确认Lambda的IAM角色拥有RDS数据访问权限，以及访问RDS所在VPC的权限（包括子网、安全组配置，确保Lambda与RDS网络互通）。本地能访问不代表Lambda角色有权限，这是常见的网络/权限盲区。
• 查看CloudWatch Lambda日志
  • 登录AWS控制台进入CloudWatch日志组，定位对应Lambda的日志流，重点查看登录成功场景下的报错堆栈。502通常是Lambda执行抛出未捕获异常或返回非标准响应导致，日志会明确显示问题（比如数据库连接超时、依赖库缺失、代码逻辑报错）。
• 调整Lambda超时与内存配置
  • 登录流程涉及数据库查询、JWT生成等操作，默认3秒超时可能不足以完成处理，尝试将超时时间调高至10秒以上，同时适当提升内存配置（Lambda内存与CPU性能正相关）。
• 验证FastAPI的Lambda适配配置
  • 确认使用mangum适配器的代码是否正确，示例如下：

    from mangum import Mangum
    from main import app
    
    handler = Mangum(app)
    

  • 检查登录成功时的响应是否符合API Gateway要求，比如响应体大小是否在限制内（API Gateway最大支持10MB响应）、状态码及响应头是否规范。
• 排查数据库连接细节
  • 确认Lambda使用RDS内网地址连接（避免公网延迟），检查连接字符串配置是否正确。同时留意RDS最大连接数是否被Lambda的并发调用耗尽，可适当调整RDS连接数或优化Lambda的连接池逻辑。
• 检查API Gateway集成配置
  • 确认API Gateway与Lambda的代理集成是否正确配置，是否存在错误的响应映射规则，导致Lambda的正常响应被错误转换为502状态码。

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