负载均衡环境下AWS Elastic Beanstalk请求返回502日志报499如何解决

问题根因说明 #

你遇到的现象核心是Classic Load Balancer（CLB）与NGINX的连接超时配置不匹配导致的：

• NGINX的499错误代表客户端在服务端返回响应前主动断开了连接
• CLB默认的空闲超时时间为60秒，如果NGINX的keepalive_timeout参数值大于60秒，CLB会先于NGINX回收空闲连接，但NGINX无法感知连接已失效，会继续将新请求转发到这条已被CLB关闭的连接，最终导致请求丢失、客户端超时断开，ELB收不到后端响应就返回502错误
• Postman请求正常是因为Postman的连接复用逻辑和浏览器/axios等库的逻辑不同，不会提前断开连接

解决方案 #

1. 对齐CLB与NGINX的超时配置 #

• 先修改CLB空闲超时：进入EC2控制台→负载均衡器→找到对应EB环境的CLB→属性→连接设置→将空闲超时调整为75秒（比NGINX默认的75秒keepalive_timeout更长即可，后续如果调整NGINX超时，需保证CLB空闲超时始终大于NGINX的keepalive_timeout10秒以上）
• 同步调整NGINX的连接配置，从根本上避免无效连接复用问题

2. 通过.ebextensions配置proxy_ignore_client_abort参数 #

在你的项目根目录创建.ebextensions文件夹，在文件夹内新建01_nginx_custom.config配置文件，内容如下：

files:
  "/etc/nginx/conf.d/proxy_custom.conf":
    mode: "000644"
    owner: root
    group: root
    content: |
      # 开启参数，客户端断开后NGINX仍继续处理后端请求，避免无效499报错
      proxy_ignore_client_abort on;
      # 对齐keepalive超时，比CLB的空闲超时短10-15秒即可，示例为CLB设75秒时的配置
      keepalive_timeout 60s;
      keepalive_requests 1000;

container_commands:
  01_reload_nginx:
    command: "service nginx reload"

将配置文件随代码一起部署到EB环境即可自动生效。

3. 额外排查项 #

如果配置完成后仍有异常，可检查以下内容：

• 确认axios/request-promise的全局超时配置是否大于接口最大响应时长
• 确认CLB安全组放开了到EC2实例80端口的出站权限，EC2实例安全组放开了CLB网段80端口的入站权限
• 确认NGINX的proxy_pass配置指向的express服务端口正常监听

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