AWS API Gateway返回200状态码但响应内容为400错误求助

当调用非代理集成的AWS API Gateway POST方法时，收到200状态码但响应内容为400 Bad Request的HTML页面，本质是API Gateway错误地将内部400异常包装成了200响应返回，可从以下方向排查解决：

1. 核对请求格式与配置匹配度 #

• 确认POST请求的Content-Type是否与API Gateway配置的请求模板完全一致。比如配置了application/json模板却发送form-data格式请求，会导致API Gateway无法解析请求体，触发400错误，若响应映射配置错误就会返回200状态码。
• 验证请求体结构是否符合后端服务的要求。非代理集成下，API Gateway会按模板转换请求，若请求体不符合模板规则，会直接引发解析失败的内部错误。

2. 检查集成响应的状态码映射 #

• 进入API Gateway控制台，找到对应POST方法的集成响应设置：
  • 排查是否将后端返回的400错误错误映射为200状态码，比如错误配置了状态码映射规则。
  • 确认是否开启了默认映射，若默认映射将所有错误统一映射到200，就会出现这种矛盾的响应结果。

3. 查看API Gateway执行日志 #

• 在API Gateway的阶段设置中启用CloudWatch日志记录（日志级别选INFO或ERROR）。
• 调用API后，到CloudWatch日志组查看详细执行日志，日志会明确标记是请求解析失败、集成请求出错还是响应映射配置错误，精准定位问题根源。

4. 验证后端服务可用性 #

• 绕过API Gateway直接调用后端服务，确认后端是否能正常处理请求。如果后端本身返回400，需排查后端业务逻辑；如果后端响应正常，问题则出在API Gateway的请求转换或响应映射配置上。

5. 检查请求头合法性 #

• 排查请求头是否包含特殊字符、不符合AWS规范的字段，或者缺少API Gateway要求的必要头信息，这类问题可能触发400错误，若状态码映射错误就会返回200响应。

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