AWS API Gateway 4XX/5XX错误（含413）的CloudWatch日志查询方案

一、CloudWatch Insights快速查询语句 #

1. 精准定位413错误日志 #

针对API Gateway的访问日志组，使用以下查询直接筛选出所有413错误的请求详情，包括发生时间、请求路径、客户端IP等关键信息：

fields @timestamp, @message, requestId, status, requestSize
| filter status = 413
| sort @timestamp desc
| limit 100

2. 批量排查所有4XX错误 #

如果需要查看所有4XX级别的错误日志，替换筛选条件即可：

fields @timestamp, @message, requestId, status, requestSize
| filter status >= 400 and status < 500
| sort @timestamp desc
| limit 200

二、使用说明 #

• 打开CloudWatch控制台，进入Insights页面
• 选择对应的API Gateway日志组（命名格式通常为API-Gateway-Logs_<API-ID>_<Stage>）
• 设置合适的时间范围（比如最近1小时/最近6小时），粘贴上述查询语句后执行

三、额外排查要点 #

• API Gateway的请求体大小限制：REST API默认最大10MB，HTTP API默认最大1MB，若超出会直接返回413，此时Lambda不会收到请求，无需排查Lambda日志
• 若使用Lambda代理集成，需确认Lambda的payload限制（同步调用最大6MB，异步调用最大256KB），但413错误绝大多数是API Gateway层面的拦截
• 可在API Gateway的阶段设置中调整Maximum payload size参数（注意不要超过服务限额）

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