Nginx 反代后端耗时超过 60 秒就报 504 Gateway Timeout,proxy_read_timeout 怎么调才合理

现象:接口偶尔 504,恰好后端 PHP 跑满 60 秒

后端同事反馈一个长耗时接口,PHP 脚本跑完要 80 秒左右,线上却在 60 秒就被 Nginx 切断返回 504 Gateway Timeout。php-fpm 日志里请求完整执行完毕、数据也写进数据库了,但客户端拿到的是 504 页面。调 PHP 的 max_exeCution_time 没用,问题出在 Nginx 反代层。

原因:proxy_read_timeout 默认就是 60 秒

Nginx proxy_read_timeout 控制 Nginx 从上游(PHP-FPM、后端 API)读响应的等待时间,和 proxy_send_timeout 一起决定反代层最多允许上游跑多久。默认都是 60 秒,上游在这 60 秒内没返回任何数据块,Nginx 就判定超时、关连接、给客户端发 504。

# 默认值就是 60s,nginx.conf http/server/location 里都能改
proxy_read_timeout   60s;
proxy_send_timeout   60s;
proxy_connect_timeout 60s;

调大不是唯一解,先确认瓶颈在哪

把 $upstream_response_time 和 $request_time 加进 access_log 对比:如果 upstream_response_time 接近但不超 60s,就是刚好卡线;如果远小于 60s 也报 504,查有没有中间层(CDN、LB)超时更短。确认瓶颈在 proxy_read_timeout 后再调,建议按业务设 120s-300s,没必要拉到 3600s,因为 Chrome 默认超时约 5 分钟。

location /api/long-task/ {
    proxy_pass http://php-fpm-backend;
    proxy_read_timeout 300s;
    proxy_send_timeout 300s;
    proxy_buffering on;   # 开缓冲,上游慢时不让客户端空等
}

调大之后记得做防御

proxy_read_timeout 调大意味着 Nginx worker 会被慢请求占更久,并发上来可能 worker_connections 被打满。建议同时开 proxy_buffering、配好 upstream 块的 keepalive,让空闲 worker 能复用连接,不让反代层成新瓶颈。这类长耗时接口再加个幂等键或任务 ID,客户端重试时不会重复执行。

总结:反代层 504 先看 access_log 里的 upstream_response_time,不要调 PHP 参数。proxy_read_timeout 默认 60 秒是常见隐性卡点,知道它在哪就能快速定位。调大后关注 worker 连接数和客户端超时上限。

您可以还会对下面的文章感兴趣: