AWS API Gateway跨域（CORS）问题解决求助

我之前也碰到过一模一样的问题——明明在API Gateway里开了CORS，前端还是报这个错，折腾了好一会儿才捋清楚问题所在。给你梳理几个最关键的排查和解决步骤，按顺序来试：

1. 先确认OPTIONS预检请求的响应头配置正确 #

浏览器发起跨域POST请求前，会先发一个OPTIONS预检请求，你的MOCK集成必须给这个请求返回正确的CORS头，否则直接就卡在这里了。

检查步骤：

• 进入API Gateway控制台，找到你的API的OPTIONS方法
• 点击「集成响应」，展开200状态码的设置
• 确认在「响应头」里添加了这几个核心字段：
  • Access-Control-Allow-Origin：设为*（测试阶段用，生产环境建议指定你的前端域名）
  • Access-Control-Allow-Methods：至少包含POST, OPTIONS（要覆盖你的实际请求方法）
  • Access-Control-Allow-Headers：设为Content-Type,X-Amz-Date,Authorization,X-Api-Key（如果你的前端请求带了自定义头，比如token，一定要加到这里）

2. 确保POST实际请求的响应也带CORS头 #

预检请求过了之后，浏览器会发送真正的POST请求，这时候API Gateway返回的响应里也必须有Access-Control-Allow-Origin头，不然还是会报错。

有两种处理方式：

• 方式一：让Lambda直接返回CORS头
  以Node.js Lambda为例，在返回对象里加上headers字段：

  exports.handler = async (event) => {
      const response = {
          statusCode: 200,
          headers: {
              'Access-Control-Allow-Origin': 'https://your-frontend-domain.com', // 替换成你的前端域名
              'Access-Control-Allow-Credentials': true // 如果需要带Cookie的话开启
          },
          body: JSON.stringify('Request processed successfully!')
      };
      return response;
  };
  

• 方式二：在API Gateway的POST集成响应中配置
  如果不想修改Lambda代码，也可以在POST方法的「集成响应」里，给200状态码添加Access-Control-Allow-Origin头，值设为*或指定域名。

3. 一定要重新部署API！这步最容易忘！ #

不管你改了什么配置，必须重新部署API到对应的阶段，否则所有修改都不会生效。

操作步骤：

• 在API Gateway控制台顶部点击「部署API」
• 选择你要部署的阶段（比如prod），随便加个描述后确认部署

4. 排查其他潜在问题 #

如果上面几步都做了还是报错，看看这些点：

• 浏览器缓存：清除浏览器缓存，或者用隐身模式测试，避免旧的错误响应被缓存
• 自定义域名/CDN：如果用了CloudFront或者自定义域名，要确保CDN配置允许转发CORS头，并且清空CDN缓存
• Lambda执行状态：先单独测试Lambda是否能正常返回结果，如果Lambda返回5xx错误，也可能导致浏览器抛出CORS相关的误导性报错
• 请求头匹配：如果你的$.ajax请求带了额外的自定义头（比如Authorization），要确保这个头已经加到OPTIONS方法的Access-Control-Allow-Headers列表里

最后建议用浏览器开发者工具的Network标签，查看OPTIONS和POST请求的响应头，确认Access-Control-Allow-Origin是否存在，这样能快速定位问题出在哪个请求环节。

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