504错误由Nginx网关超时引发，需同步调整Nginx的fastcgi_read_timeout、PHP-FPM的request_terminate_timeout及脚本层ini_set，并重启服务；盲目延长超时掩盖真实瓶颈，应优先排查慢查询、远程请求阻塞等根因。
phpEnv 本身不直接产生 504 错误，它只是 PHP 运行环境管理工具；真正返回 504 的是 Nginx（或 Apache）——你看到的 504 是网关超时，不是 phpEnv 卡住了。
为什么改 phpEnv 的 php.ini 没用？
phpEnv 管理的是 CLI 模式下的 PHP 配置，而 Web 请求走的是 PHP-FPM（FastCGI）模式。这两者配置完全分离：
-
php -i | grep max_execution_time查到的是 CLI 的值，对网页请求无效 - Web 请求受
php-fpm.conf（如request_terminate_timeout）和 Nginx 的fastcgi_read_timeout共同约束 - phpEnv 修改的
php.ini文件路径（如~/.phpenv/versions/8.1.0/etc/php.ini）只影响php -f script.php这类命令行执行
phpEnv 环境下真正要调的三个位置
在 phpEnv + Nginx 组合中，504 超时链路是：Nginx → fastcgi → PHP-FPM → PHP 脚本。必须同步调整这三环：
-
Nginx 层：编辑站点配置，在
location ~ \.php(.*)$块内确保有：fastcgi_read_timeout 300;fastcgi_send_timeout 300;fastcgi_connect_timeout 300; -
PHP-FPM 层：找到对应版本的 FPM 配置文件，路径类似
~/.phpenv/versions/8.1.0/etc/php-fpm.d/www.conf，修改：request_terminate_timeout = 300（注意：不是max_execution_time）pm.max_children = 32（防进程耗尽导致排队超时） -
PHP 脚本层：若需临时延长单脚本限制（仅限调试），在脚本开头加：
ini_set('max_execution_time', '300');—— 但不能写set_time_limit(0)，FPM 下无效
容易被忽略的关键点
很多用户以为改完就完事，结果还是 504，问题常出在：
立即学习“PHP免费学习笔记（深入）”；
- 没重启 PHP-FPM 进程：
~/.phpenv/bin/php-fpm --stop && ~/.phpenv/bin/php-fpm（确认用的是当前版本的二进制） - 没重载 Nginx：
nginx -s reload或手动 kill -HUP 主进程 - 用了
.user.ini或php_admin_value覆盖了设置，得检查是否被更高优先级配置覆盖 - 脚本卡在 DNS 解析、curl 远程请求、数据库锁上——这时调超时只是掩耳盗铃，得用
strace -p $(pgrep -f 'php-fpm.*www') -e trace=connect,sendto,recvfrom定位真瓶颈
超时参数调高只是兜底手段，真正该花时间看的是错误日志里有没有 PDOException、mysqli::query(): MySQL server has gone away 或慢查询痕迹。504 往往是症状，不是病根。
