调优 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免费学习笔记（深入）”；
配套调整可避免中间环节卡死
除了最核心的 fastcgi_read_timeout，还建议一并设置另外两个关联超时，防止连接建立或请求发送阶段就失败：
-
fastcgi_connect_timeout 360：Nginx 连 PHP-FPM 的建连时限（同机部署可设小些，如 10） -
fastcgi_send_timeout 360：Nginx 向 PHP-FPM 发送完整请求体的最长时间 - 三个值保持一致或接近，能减少因某一段超时导致的假性 504
验证是否真正生效
别只看配置文件，要用实际请求测试：
- 写个测试脚本
sleep.php：<?php sleep(240); echo "done"; ?> - 访问它，观察是否返回 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)）确保配置重载
