跳转到主内容
websoft网络软件专家 - 深耕网络技术,打造实用软件!

如何通过调优 fastcgi_read_timeout 解决 PHP 长耗时脚本超时

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

相关文章