AWS API Gateway POST路由关联Lambda后返回'Not Found'问题排查

以下是导致API Gateway返回"Not Found"的常见原因及对应排查点：

1. 未部署API Gateway阶段 #

这是最常见的问题：配置完路由和集成后，必须将API部署到某个**阶段（Stage）**才能对外访问。

• 登录AWS控制台，进入API Gateway服务，找到目标API；
• 点击顶部的部署API按钮，选择或创建一个阶段（比如prod）完成部署；
• 部署后，访问URL需要包含阶段名称，正确格式应为：https://yiea29chwl.execute-api.ca-central-1.amazonaws.com/prod/track_req_submit（替换prod为你的实际阶段名）。

2. 请求URL路径不匹配 #

• 确认API Gateway中创建的资源路径是/track_req_submit：检查该资源是否直接创建在根路径（/）下，而非嵌套在其他资源（比如/api/track_req_submit）中；
• 核对Postman中使用的URL是否与部署后的阶段URL完全一致，包括路径大小写、阶段前缀。

3. 路由方法配置错误 #

• 确认POST /track_req_submit方法直接绑定在/track_req_submit资源上，而非根资源（/）的POST方法；
• 若同时配置了ANY /track_req_submit和POST /track_req_submit，确保POST方法的集成配置正确关联了目标Lambda函数xbmf7fm，且API Gateway的方法请求路径与实际请求路径完全匹配。

4. Lambda集成类型不匹配 #

• 确认API Gateway的集成类型为Lambda代理集成（这与你使用的Lambda测试事件格式一致）；
• 如果是非代理集成，需手动配置请求映射模板，确保Lambda能正确解析请求体结构。

5. 域名信息核对 #

检查Postman中使用的API Gateway域名区域（ca-central-1）和ID（yiea29chwl）是否与控制台中的信息完全一致，避免复制错误。

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