调优 fastcgi_read_timeout 是解决 PHP 长耗时脚本返回 504 的关键,但必须与 PHP 的 max_execution_time 和 PHP-FPM 的 request_terminate_timeout 同步设置,三者需满足 ≤ 关系,且 fastcgi_read_timeout 须置于 location 或 server 块中,配合 fastcgi_connect_timeout、fastcgi_send_timeout 并通过 sleep.php 实际验证。
调优
fastcgi_read_timeout
是解决 PHP 长耗时脚本返回 504 Gateway Timeout 的关键一步,但它不是单独起作用的。这个参数只控制 Nginx 等待 PHP-FPM 返回完整响应的时间,若其他环节超时更早,改它也没用。
必须放在 location 或 server 块里才生效
该指令不支持写在
块中,否则 Nginx 启动会报错:“directive is not allowed here”。正确位置是:
在站点配置文件(如
)中,找到
块
在
行之后插入:
数值建议设为略大于 PHP 脚本预期最大耗时(比如脚本要跑 5 分钟,这里设 360 秒)
不能只调这一个,三处超时必须对齐
fastcgi_read_timeout 只是链条中的一环。以下三项必须同步设置且满足大小关系:
PHP 层
:
(
php
.ini 中)
Nginx 层
:
(需 ≥ 上一项)
PHP-FPM 层
:
(www.conf 中,优先级最高)
任意一项偏小,请求都会被掐断——例如 request_terminate_timeout 还是默认 30 秒,那脚本运行到第 30 秒就被强制 kill,Nginx 即使等 360 秒也收不到响应。
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑,通过深度错误修复、底层性能微调以及安全加固,旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范,不包含破坏性变更。
下载
立即学习
“
PHP免费学习笔记(深入)
”;
配套调整可避免中间环节卡死
除了最核心的
,还建议一并设置另外两个关联超时,防止连接建立或请求发送阶段就失败:
:Nginx 连 PHP-FPM 的建连时限(同机部署可设小些,如 10)
:Nginx 向 PHP-FPM 发送完整请求体的最长时间
三个值保持一致或接近,能减少因某一段超时导致的假性 504
验证是否真正生效
别只看配置文件,要用实际请求测试:
写个测试脚本
:
访问它,观察是否返回 504;若成功,再检查 Nginx 错误日志中是否有
执行
和对应版本的
(或
)确保配置重载
http/usr/local/nginx/conf/vhost/xxx.conflocation ~ \.php$ { ... }fastcgi_passfastcgi_read_timeout 360;max_execution_time = 300fastcgi_read_timeout 360request_terminate_timeout = 360fastcgi_read_timeoutfastcgi_connect_timeout 360fastcgi_send_timeout 360sleep.phpupstream timed outnginx -t && nginx -s reloadphpenv restart php-fpm-81kill -USR2 $(cat /usr/local/php/var/run/www.pid)