如何在AWS Elastic Beanstalk中替换502 Bad Gateway为自定义错误页？

方案1：Application Load Balancer（ALB）自定义错误规则 #

这是最省心的方案，完全绕开之前的DNS缓存和CloudFront超时问题：

• 先确认你的Elastic Beanstalk环境用的是ALB（如果是经典负载均衡，建议先升级）。
• 登录ALB控制台，找到对应环境的监听器，新增一条规则：
  • 条件选「HTTP响应代码」，匹配502
  • 操作选「返回固定响应」：
    • 响应代码保持502，避免客户端误判状态
    • 内容类型设为text/html
    • 响应主体直接贴自定义错误页的HTML代码；如果页面大，就把静态页传到S3（设为公开或仅限ALB访问），把S3的URL填进去也行。
• 优点：不用改DNS，没缓存问题；负载均衡层直接拦截错误，响应快；完全不影响原应用的长请求超时设置。

方案2：ALB+Lambda故障 fallback #

如果需要更灵活的逻辑（比如故障时记录日志、根据场景返回不同页面），可以这么搞：

• 给ALB配置两个目标组：主目标组指向Elastic Beanstalk的实例，备用目标组绑定一个Lambda函数。
• 当主目标组的所有实例健康检查失败时，ALB自动把请求转到Lambda，Lambda直接返回自定义502错误页的HTML内容。
• 也可以加个监控逻辑：用CloudWatch告警检测ALB的502次数，触发Lambda动态切换ALB规则，故障恢复后再切回去——不过这个适合复杂场景，一般用上面的简单版就行。

方案3：修改Elastic Beanstalk的Web服务器配置（EC2环境专属） #

如果你的环境是EC2实例（不是容器），可以直接改NGINX/Apache的配置：

• NGINX环境：
  1. 在项目根目录建.ebextensions/nginx/conf.d/custom_errors.conf文件
  2. 写入：

  error_page 502 /502.html;
  location = /502.html {
      root /var/www/html;
      internal;
  }
  

  3. 把自定义的502.html放到项目的静态资源目录（比如public），部署时会自动同步到EC2实例。
• Apache环境：
  1. 建.ebextensions/apache/conf.d/custom_errors.conf文件
  2. 写入：

  ErrorDocument 502 /502.html
  

  3. 同样把502.html放到对应目录。
• 注意：这个方案只能覆盖Web服务器自身返回的502，如果是负载均衡层因实例全挂返回的502，就没用了，适合局部故障场景。

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