Nginx 504 Gateway Timeout 怎么办？超时优化与排查指南

网站突然报 504 Gateway Timeout，说明 Nginx 把请求转给了后端（PHP-FPM、Node、Java 等），但后端在限定时间内没给回结果，Nginx 等不及就报了超时。它和 502 不一样：502 是后端”连不上或者直接挂了”，504 是后端”连上了但太慢”。这篇文章从定位到解决，带你完整走一遍。

第一步：确认是谁在超时

先看 Nginx 的错误日志，确认到底超时在哪：

tail -50 /var/log/nginx/error.log

典型日志是 upstream timed out (110: Connection timed out) while reading response header from upstream，说明后端处理太慢。再确认一下后端进程还活着没、负载正不正常：

systemctl status php-fpm
top
uptime

要是 CPU 或负载爆了，问题就在后端性能本身；如果负载正常但个别接口超时，多半是某个慢请求（慢 SQL、外部 API 调用）拖住了。

第二步：找到慢在哪里

PHP 环境下把 PHP-FPM 慢日志打开，它能直接把卡住的函数调用栈打印出来：

# php-fpm.d/www.conf
slowlog = /var/log/php-fpm/slow.log
request_slowlog_timeout = 5s

重启 PHP-FPM 之后复现一下问题，去看 slow.log。常见的根因排个序：慢 SQL 查询（缺索引）、调第三方接口没设超时、循环里处理大批量数据、磁盘 IO 瓶颈。数据库这边也可以把 MySQL 慢查询日志打开一起查：

SET GLOBAL slow_query_log = ON;
SET GLOBAL long_query_time = 2;

第三步：合理调大超时参数（应急）

如果某些请求本来就很耗时（比如报表导出、大文件处理），可以针对性地把 Nginx 超时调大，在对应的 location 或 server 块里加：

proxy_connect_timeout 60s;
proxy_send_timeout    120s;
proxy_read_timeout    120s;
# fastcgi 场景（PHP）用：
fastcgi_read_timeout  120s;

同时确认后端自己的执行时间限制也跟上，否则 Nginx 在那等，PHP 却先掐断了：

; php.ini
max_execution_time = 120
; www.conf
request_terminate_timeout = 120s

改完先 nginx -t 检查语法，再 systemctl reload nginx。注意：调大超时只是止血，把全站超时一股脑改成 300 秒，反而会让慢请求堆积、连接耗尽，故障被放大。

第四步：从根上优化，避免复发

长期方案按优先级做这几件事：给慢 SQL 加索引或改写查询；调第三方接口时设 3–5 秒超时并做降级；耗时任务改成异步队列（用户提交后后台跑，前端轮询结果）；热点数据加 Redis 缓存；PHP-FPM 按内存合理调 pm.max_children，别让进程排队。这几样做完，绝大多数 504 都会消失。