配置Mailchimp Webhook至API Gateway时遇404错误求助

一、404 错误的常见原因 #

• 端点URL不正确：确认使用的是API Gateway已部署阶段的正式URL，而非控制台的临时测试链接；检查URL中的资源路径、阶段名是否与配置完全一致，避免拼写错误。
• 资源与方法不匹配：确保API Gateway中对应资源已配置POST方法，且该方法已正确集成到目标Lambda函数。如果仅配置了GET方法，Mailchimp的POST请求会返回404。
• 未重新部署阶段：修改API Gateway配置后，必须重新部署到对应阶段，否则新配置不会生效，请求仍会指向旧的无效资源。
• 隐性权限问题：部分场景下，API Gateway因无Lambda调用权限会返回404（而非预期的500）。需检查：
  • API Gateway的执行角色是否拥有lambda:InvokeFunction权限；
  • Lambda函数的资源策略是否允许API Gateway作为触发源调用。

二、API Gateway 兼容 application/x-www-form-urlencoded 的配置要点 #

Mailchimp Webhook以application/x-www-form-urlencoded格式发送数据，需针对API Gateway做以下配置：

• Lambda Proxy集成（推荐）：
  选择Lambda Proxy集成后，API Gateway会自动将请求的form数据封装到Lambda事件的body字段中。Lambda代码需自行解析该字符串，例如Node.js中可使用：

  const querystring = require('querystring');
  const formData = querystring.parse(event.body);
  

• 非Proxy集成的请求模板：
  若使用非Proxy集成，需在集成请求中添加application/x-www-form-urlencoded的请求模板，将form数据映射到Lambda能识别的格式，示例模板：

  {
    "email": "$input.params('email')",
    "event_type": "$input.params('type')"
  }
  

  或更通用的映射：

  { "body": $input.json('$') }
  

• 方法请求参数校验：
  检查方法请求中是否配置了必填的查询参数或路径参数，若Mailchimp未传递这些参数，请求会被拦截返回404，需移除不必要的强制参数校验。
• CORS 配置：
  Mailchimp可能发送OPTIONS预检请求，需在API Gateway中配置CORS，允许对应的请求来源、方法和头部，避免预检失败导致后续POST请求被拦截。

三、验证步骤 #

1. 用Postman或curl模拟请求：发送POST请求到API Gateway URL，设置Content-Type: application/x-www-form-urlencoded，body填入测试form数据，检查是否能触发Lambda并返回2xx响应。
2. 查看CloudWatch日志：开启API Gateway阶段的日志记录，通过日志排查请求是否到达资源、是否有权限或映射错误。

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