Nginx 出现 504 Gateway Time-out 通常是因为后端服务在指定时间内未响应，最直接的处理方向是调整 Nginx 的代理超时参数，适用于后端处理耗时较长的场景。风险边界在于单纯延长超时可能掩盖后端性能瓶颈，需结合后端日志共同排查。

命令速用版

在 Nginx 配置文件的 location 块中添加或修改以下参数，将超时时间调整为合适值（例如 300 秒）：

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

修改后执行重载命令：

nginx -t && nginx -s reload

为什么会这样

504 错误本质是 Nginx 作为网关在等待上游服务器响应时超过了预设时间。Nginx 默认等待上游响应的时间为 60 秒，若后端业务逻辑复杂、数据库查询慢或网络波动导致处理时间超过该阈值，Nginx 会主动断开连接并返回 504 状态码。

分步处理

步骤 1：定位超时日志
查看 Nginx 错误日志，确认报错信息包含 upstream timed out。默认日志路径通常为 /var/log/nginx/error.log。

grep "upstream timed out" /var/log/nginx/error.log

步骤 2：调整配置参数
编辑 Nginx 配置文件（通常位于 /etc/nginx/nginx.conf 或 conf.d 下的站点配置），在 server 或 location 块中增加超时设置。注意不要全局盲目调大，仅针对特定耗时接口调整。

步骤 3：检查后端服务
登录后端应用服务器，检查应用日志是否存在慢查询或死锁。若后端本身无响应，调整 Nginx 超时无效。

步骤 4：重载配置
执行配置测试并重载，确保语法无误。

怎么验证是否生效

使用 curl 命令发起请求并观察响应时间，同时监控 Nginx 错误日志不再出现 504 记录。

curl -I -w "Time: %{time_total}s\n" https://your-domain.com/path

若返回状态码为 200 且 Time 数值小于配置的超时时间，说明调整生效。若仍出现 504，需继续增大超时值或优化后端性能。

常见坑

• 盲目将超时时间设置为无限大，导致请求堆积占用连接资源。
• 只调整 Nginx 配置，忽略后端 PHP-FPM、Tomcat 或数据库自身的超时设置。
• 修改配置后未执行 nginx -t 检查语法，直接 reload 导致服务中断。

常见问题

504 和 502 错误有什么区别？

502 是 Bad Gateway，表示 Nginx 收到的上游响应无效或连接被拒绝；504 是 Gateway Timeout，表示上游服务存活但处理太慢。

调整超时时间会影响服务器性能吗？

单纯调整超时参数不直接提升性能，但过长的超时会占用 worker 连接数，高并发下可能导致新请求无法建立连接。

为什么改了配置还是 504？

可能后端服务本身卡死、网络链路存在防火墙拦截，或 PHP-FPM 等后端进程池已满，需检查后端应用日志。

参考来源

• Nginx Official Documentation, Module ngx_http_proxy_module, Directive proxy_read_timeout
• Nginx Official Documentation, HTTP Status Codes