AWS API Gateway返回502 Bad Gateway错误 无CloudWatch日志如何排查

问题结论 #

响应大小超过API Gateway的配额限制，确实会触发你遇到的502 Bad Gateway错误
你收到的错误返回符合API Gateway响应超限的典型表现：

502: Bad Gateway
{
    "message": "Internal server error"
}

配额规则说明 #

不同类型API Gateway的响应载荷上限不同：

• REST API/HTTP API：响应最大允许10MB
• WebSocket API：响应最大允许32KB
  当后端集成返回的响应体积超过对应阈值时，API Gateway会直接拦截请求，返回上述通用错误，不会将超限内容转发给客户端。

CloudWatch无日志的原因 #

该场景下日志缺失是正常现象，常见原因有两个：

1. 你未开启API Gateway的全量执行日志，仅开启访问日志、或日志级别设置为ERROR以下时，这类拦截错误不会被记录到CloudWatch
2. 响应超限错误发生在API Gateway的响应后置处理阶段，部分场景下不会关联原始请求的上下文，不会生成对应的请求日志

验证&排查方案 #

你可以通过以下步骤确认问题根因：

• 调整后端服务逻辑，强制返回小体积响应测试，如果小响应可以正常返回，即可确认是响应超限问题
• 在后端服务侧新增日志，统计接口返回的实际Payload体积，确认是否超出API Gateway的对应配额
• 将API Gateway的日志级别临时调整为INFO，开启全量执行日志后复现问题，即可在CloudWatch中看到明确的Response payload size exceeded maximum allowed payload size报错

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