Elasticbeanstalk返回Nginx 504 Gateway Timeout错误如何解决

该错误是Elastic Beanstalk默认的各层超时配置低于你接口的1分钟响应时长导致，按以下步骤调整即可：

调整Nginx代理超时配置 #

在项目根目录下创建.platform/nginx/conf.d/proxy.conf文件，写入以下配置，时长可根据你接口的实际最大响应时间调整，建议多留20%以上冗余：

# 单位为秒，此处示例配置为2分钟超时
proxy_connect_timeout 120s;
proxy_send_timeout 120s;
proxy_read_timeout 120s;
send_timeout 120s;

将该配置文件随代码一起打包部署到Elastic Beanstalk，平台会自动加载自定义的Nginx配置。

调整应用服务器超时配置 #

需要对应调整你使用的应用服务器的超时参数，避免应用服务器先于Nginx断开连接：

• Gunicorn：启动命令中添加--timeout 120参数
• uWSGI：配置文件中添加http-timeout = 120
• Node.js Express：代码中添加server.timeout = 120000（单位为毫秒）
• Spring Boot：配置文件中添加server.servlet.session.timeout=120s

调整负载均衡空闲超时（使用ALB/CLB时需要） #

如果你的Elastic Beanstalk环境配置了负载均衡，还需要修改负载均衡的空闲超时时间：

1. 进入AWS Elastic Beanstalk控制台，打开对应环境页面
2. 切换到「配置」选项卡，找到「负载均衡」配置项
3. 将「空闲超时」参数修改为大于你设置的接口超时的数值，保存后等待环境更新完成。

可选优化方案 #

如果接口的长耗时是因为处理批量任务、大文件计算等场景，建议改为异步交互逻辑：接口收到请求后立即返回唯一的请求ID，后端异步执行任务，用户后续通过请求ID轮询查询处理结果，从根本上避免长连接超时问题。

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