服务器宕机时为何出现CORS错误？Node.js后端AWS部署问题

为什么生产环境会出现CORS错误？ #

本地环境中，服务器未启动时请求直接无法建立TCP连接，浏览器返回net::ERR_CONNECTION_REFUSED；但生产环境的EC2实例宕机时，请求大概率经过了AWS的中间组件（比如弹性负载均衡ELB、CloudFront CDN）——当后端实例不可用时，这些组件会返回默认错误响应（如503 Service Unavailable），但该响应未携带CORS所需的Access-Control-Allow-Origin等头信息，浏览器因此判定为CORS缺失错误，而非连接失败。

解决方案 #

1. 配置AWS中间组件的错误响应CORS头 #

如果使用了ELB或API Gateway：

• 对于ELB：在监听器规则中添加针对5xx状态码的响应头配置，强制返回Access-Control-Allow-Origin: *（或你的前端域名）、Access-Control-Allow-Methods等必要CORS头。这样即使后端宕机，ELB返回的错误响应也符合CORS规则，浏览器会显示真实的HTTP错误码（如503），而非CORS错误。
• 对于API Gateway：在网关的错误响应模板中添加CORS头，确保所有错误响应都携带合法的跨域头。

2. 前端全局错误拦截与自定义提示 #

在前端的请求封装层（比如Axios、Fetch的统一拦截器）中，做以下处理：

// 以Axios为例
axios.interceptors.response.use(
  response => response,
  error => {
    // 区分错误类型
    if (error.code === 'ERR_CONNECTION_REFUSED' || error.response?.status >= 500) {
      alert('Server is Down');
    } else if (error.name === 'AxiosError' && error.message.includes('CORS')) {
      // 兜底判定为后端不可达，提示服务器宕机
      alert('Server is Down');
    }
    return Promise.reject(error);
  }
);

这样不管是连接拒绝还是后端宕机引发的CORS错误，都能给用户统一的自定义提示。

3. 配置健康检查与自定义错误页面 #

在ELB中配置EC2实例的健康检查规则，当实例连续失败时，让ELB返回自定义的错误页面：

• 自定义页面携带CORS头，同时返回明确的错误信息（如JSON格式的{"msg": "Server is Down"}）
• 前端解析该响应后直接展示自定义提示。

4. 避免直接请求EC2公网IP #

不要让前端直接请求EC2的公网IP，而是通过ELB或API Gateway代理请求。这样所有错误响应都能被中间组件统一处理，避免出现无CORS头的默认错误。

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