AWS Lambda经API Gateway调用返回502错误：响应格式异常排查

你遇到的这个502错误的核心原因，是Lambda返回的响应格式里的状态码字段名称不符合API Gateway代理集成的要求——你用了status，但网关要求的是**statusCode**（驼峰写法，注意大写的C）。

从你提供的日志内容来看，转换前的端点响应体是：

{"status":200,"body":"{"Items":[],"Count":0,"ScannedCount":1}","isBase64Encoded":false,"headers":{"content-type":"application/json"}}

API Gateway的Lambda代理集成对响应格式有严格的字段名要求，它只会识别statusCode来确定HTTP响应状态码，无法识别小写的status字段。缺少这个正确的字段，网关就会判定响应格式无效，直接返回502错误。

修复步骤 #

• 修改你的Lambda函数，将响应中的status字段替换为statusCode，比如把"status":200改成"statusCode":200。
• 其余部分的格式是正确的：body已经是序列化后的JSON字符串，isBase64Encoded是布尔值，headers也设置了正确的content-type，这些不需要调整。

修复后的正确响应结构示例：

{"statusCode":200,"body":"{\"Items\":[],\"Count\":0,\"ScannedCount\":1}","isBase64Encoded":false,"headers":{"content-type":"application/json"}}

这种字段名的拼写/大小写错误是Lambda代理集成里的高频坑，只要严格匹配官方要求的字段名，这个502问题就能解决。

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