API Gateway接收x-www-form-urlencoded POST请求返回415错误如何解决

• 方法请求层内容类型限制：你只在「集成请求」中配置了映射模板，但是未在「方法请求」模块的「请求内容类型」列表中添加application/x-www-form-urlencoded，API Gateway会在方法校验层直接拦截未声明支持的内容类型，返回415错误，这是最常见的原因。
• Content-Type请求头值不完整：你测试时填写的请求头值为x-www-form-urlencoded，缺失了必填的前缀，正确完整的请求头应为Content-Type: application/x-www-form-urlencoded，值不匹配会导致模板无法命中。
• 映射模板匹配规则问题
  • 内容类型配置存在拼写错误、多余空格，或者请求头携带了charset等额外参数（比如application/x-www-form-urlencoded; charset=utf-8），API Gateway对内容类型的匹配是严格精确匹配，参数不一致会导致匹配失败。
  • 集成请求的「请求体穿透」设置为「当没有匹配模板时拒绝请求」，且你配置的模板未命中的情况下会直接返回415。
• 配置未生效：修改映射模板、内容类型配置后未点击保存，或者对外提供服务的API未重新部署到对应阶段，旧配置仍然生效。
• 控制台测试参数异常：部分区域的API Gateway控制台测试工具存在请求头解析异常，你可以保存配置后用Postman、curl等工具直接调用阶段URL验证，避免控制台测试的潜在bug。

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