Nginx反向代理出现60秒504 Gateway Time-out问题排查求助

问题描述 #

调用Nginx反向代理后的服务时频繁遇到504 Gateway Time-out错误，反向代理配置如下：

location ~ ^/myapp/some-service {
  rewrite ^/myapp/some-service(.*)$ $1 break;
  proxy_pass http://my-web.cl-myapp:80;
  proxy_redirect off;
  # proxy_pass http://my-web.cl-myapp:80/;
}

直接访问服务原URL（https://my-web.myhosting.com/test?time=61）无超时问题，即使设置?time=300也能返回200；但通过代理URL（https://subdomain.anotherhosting.cl/myapp/some-service/test?time=61）访问时，当time参数≥60秒就会触发超时，偶尔会出现其他错误，但多数情况为504超时。Nginx配置中未显式设置60秒相关超时参数，需从以下方向排查：

排查方向 #

1. 检查Nginx默认反向代理超时参数 #

Nginx内置默认超时配置，即使未显式设置也会生效，且默认值均为60秒，刚好匹配触发条件：

• proxy_connect_timeout：Nginx与后端服务建立连接的超时时间
• proxy_send_timeout：Nginx向后端发送请求的超时时间
• proxy_read_timeout：Nginx等待后端响应的超时时间

可在对应location块或http/server块中添加并调大这些参数，示例：

proxy_connect_timeout 300s;
proxy_send_timeout 300s;
proxy_read_timeout 300s;

修改后重启Nginx测试。

2. 验证Nginx到后端服务的网络链路 #

直接访问后端正常不代表Nginx服务器到后端的网络无问题，需在Nginx服务器上执行：

curl http://my-web.cl-myapp:80/test?time=300

确认是否能正常返回，同时用ping或traceroute检查链路稳定性，排查是否存在防火墙、中间路由的隐性超时限制。

3. 排查前端中间代理/CDN的超时设置 #

若Nginx前端存在CDN、负载均衡器等设备，这些中间节点可能自带60秒超时限制：

• 检查这类设备的请求超时、连接超时配置，调整为与后端服务匹配的时长
• 确认中间设备是否会主动断开长连接

4. 优化Nginx长连接配置 #

若后端依赖长连接，Nginx默认配置可能导致连接提前断开，需添加：

proxy_http_version 1.1;
proxy_set_header Connection "";
proxy_keepalive 32;

启用HTTP/1.1长连接并保持与后端的连接数量。

5. 分析Nginx错误日志定位原因 #

查看Nginx错误日志（默认路径：/var/log/nginx/error.log），搜索upstream timed out等关键词，明确是连接、发送还是读取阶段超时，针对性排查。

6. 统一请求头配置 #

通过代理访问时，后端服务可能因请求头差异（如Host、X-Forwarded系列）导致处理逻辑变化，需在Nginx配置中添加标准请求头：

proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;

确保后端接收到的请求头与直接访问时一致。

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