Python POST请求正常，React/Axios调用同API报502错误排查

这种情况核心问题很明确：你的React请求根本没到达AWS Lambda（CloudWatch无日志），但Python请求能正常触发，说明差异出在请求从Heroku代理转发到API Gateway的过程中，根源大概率是Python和React请求的格式/配置不一致，或者Heroku代理的转发逻辑有问题。下面分几个常见原因拆解：

1. 请求头部与请求体格式不匹配 #

Lambda没触发，说明API Gateway直接拒绝了请求，最常见的原因是请求格式不符合API Gateway的要求：

• Python的requests.post(url, json={"key": "value"})会自动添加Content-Type: application/json头部，并且把请求体序列化为JSON字符串；
• 但Axios如果配置不当，可能会发送错误的格式：比如没显式设置Content-Type，或者误把请求参数放在params（URL参数）而不是data（请求体）里，甚至发送FormData格式而非JSON。

举个正确的Axios POST写法对比：

// 正确写法：确保请求体是JSON，且头部正确
axios.post('/api/your-endpoint', { username: 'test' }, {
  headers: {
    'Content-Type': 'application/json'
  }
})

你可以打开浏览器开发者工具的Network标签，对比React请求和Python请求的头部、请求体差异，重点看Content-Type和请求体格式。

2. Heroku代理的路径转发错误 #

虽然Heroku日志没异常，但代理的路径拼接可能出了问题：

• 比如你在package.json里设置的proxy字段是"https://xxxx.execute-api.us-east-1.amazonaws.com/prod"，但React里请求的是/api/endpoint，这时候Heroku会转发到https://xxxx.execute-api.us-east-1.amazonaws.com/prod/api/endpoint——而你的API Gateway实际路径是/prod/endpoint，多出来的/api会导致404，API Gateway返回404后，Heroku代理可能把这个错误转换成502返回给前端。
• 解决方法：要么调整React的请求路径为/endpoint，要么修改Heroku的代理配置（比如用http-proxy-middleware自定义转发规则），确保路径完全匹配API Gateway的端点。

3. OPTIONS预请求处理失败 #

浏览器发送POST请求前会先发送OPTIONS预请求做CORS校验，如果API Gateway没配置OPTIONS方法的集成，或者CORS规则不允许Heroku域名，Heroku代理可能会返回502：

• 检查API Gateway的CORS配置：是否允许Heroku域名（https://your-heroku-app.herokuapp.com），是否允许POST和OPTIONS方法，是否允许Content-Type等必要头部；
• 可以在浏览器Network标签里看OPTIONS请求的返回状态，如果是403或其他错误，说明CORS配置有问题。

4. 请求URL的细微差异 #

比如Python请求的是https://xxxx.execute-api.us-east-1.amazonaws.com/prod/endpoint，而Heroku代理转发后的URL少了一个斜杠、多了后缀，或者环境变量配置错误（比如把测试环境的API URL放到了生产环境）。

• 你可以直接在Heroku服务器上用curl测试代理后的请求：

  curl -X POST https://your-heroku-app.herokuapp.com/api/endpoint \
    -H "Content-Type: application/json" \
    -d '{"key": "value"}'
  

  看返回结果，同时观察CloudWatch是否有日志生成，这样能快速定位是Heroku代理的问题还是API Gateway的问题。

快速排查步骤 #

1. 用浏览器Network工具对比React请求和Python请求的所有细节（URL、头部、请求体）；
2. 用curl在Heroku上直接测试代理后的请求，排除前端代码的干扰；
3. 暂时绕过Heroku代理，在React里直接调用API Gateway URL（需配置CORS允许Heroku域名），看能否触发Lambda；
4. 开启API Gateway的访问日志，查看是否有请求到达以及具体的错误信息。

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