AWS API Gateway超7成请求返回500，是否为429限流显示异常？

AWS API Gateway几乎所有请求都返回500错误，成功请求占比不足30%。执行日志如下，想咨询：请求过多触发429限流时，是否会被显示为500错误？还是有其他原因导致当前的500问题？

执行日志： #

2022-08-26T10:04:04.561-05:00

(d2181bd4-9795-4bfc-a646-f16ed77160cd) Endpoint response headers: {Date=Fri, 26 Aug 2022 15:04:04 GMT, Content-Type=application/json, Content-Length=104, Connection=keep-alive, x-amzn-RequestId=aac943ec-af03-445b-9cd4-f203b246544b, x-amzn-Remapped-Content-Length=0, X-Amz-Executed-Version=$LATEST, X-Amzn-Trace-Id=root=1-6308e0e3-101cb97e2d042e573dd35c26;sampled=1}
(d2181bd4-9795-4bfc-a646-f16ed77160cd) Endpoint response headers: {Date=Fri, 26 Aug 2022 15:04:04 GMT, Content-Type=application/json, Content-Length=104, Connection=keep-alive, x-amzn-RequestId=aac943ec-af03-445b-9cd4-f203b246544b, x-amzn-Remapped-Content-Length=0, X-Amz-Executed-Version=$LATEST, X-Amzn-Trace-Id=root=1-6308e0e3-101cb97e2d042e573dd35c26;sampled=1}

2022-08-26T10:04:04.561-05:00

(d2181bd4-9795-4bfc-a646-f16ed77160cd) Endpoint response body before transformations: 
{
    "statusCode": 500,
    "headers": {
        "Content-Type": "application/json"
    },
    "body": "Unable to handle request"
}
(d2181bd4-9795-4bfc-a646-f16ed77160cd) Endpoint response body before transformations: {"statusCode": 500, "headers": {"Content-Type": "application/json"}, "body": "Unable to handle request"}

2022-08-26T10:04:04.562-05:00

(d2181bd4-9795-4bfc-a646-f16ed77160cd) Method response body after transformations: Unable to handle request
(d2181bd4-9795-4bfc-a646-f16ed77160cd) Method response body after transformations: Unable to handle request

问题解答： #

1. 请求过多（429）不会默认显示为500
   正常情况下，当API Gateway触发限流（请求数超过阈值），会直接返回429 Too Many Requests响应，不会转换成500。只有自定义了API Gateway的错误映射规则时，才可能将429映射为500，但这属于特殊配置，并非默认行为。

2. 当前500错误的根源是后端服务
   从日志可见，Endpoint response body before transformations里明确返回了statusCode: 500，说明是后端端点（日志中的X-Amz-Executed-Version=$LATEST表明这是Lambda函数）抛出的错误，而非API Gateway本身的限流问题。

3. 可能的具体原因

• Lambda函数代码存在未捕获的异常，或执行逻辑出错，导致返回"Unable to handle request"的500响应
• Lambda并发配额耗尽：此时Lambda会返回429，但如果API Gateway配置了错误映射，可能被转为500（概率低，需排查配置）
• Lambda执行超时、内存不足，或依赖的其他服务（如数据库、第三方API）故障，导致无法处理请求
• API Gateway与Lambda的集成配置错误（如权限、路径不匹配），导致后端无法正常处理请求

4. 排查建议

• 查看Lambda函数的详细执行日志（CloudWatch Logs），定位"Unable to handle request"的具体触发原因
• 检查Lambda的并发指标（CloudWatch的ConcurrentExecutions），确认是否达到配额上限
• 发送单个测试请求，复现500错误后逐步排查代码逻辑
• 检查API Gateway的集成响应配置，确认是否存在将429映射为500的规则

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