upstream timed out 错误源于 Nginx、PHP-FPM、PHP 脚本三层超时未对齐：fastcgi_read_timeout（Nginx）必须 ≥ request_terminate_timeout（php-fpm.conf）＞ max_execution_time（php.ini），否则任一层提前终止均触发该错误；phpEnv 仅管理配置路径，不自动同步三者，需手动校验并重启对应服务。
phpEnv 本身不解决 upstream timed out，它只是 PHP 环境管理工具；真正要调的是 Nginx 的 proxy_read_timeout、PHP-FPM 的 request_terminate_timeout，以及两者之间的超时对齐。
为什么 phpEnv 配置改了却还报 upstream timed out
phpEnv 只负责安装、切换 PHP 版本和管理 php.ini / php-fpm.conf 路径，它不自动同步或校验 Nginx 的代理超时参数。常见误区是：只调了 max_execution_time=300，但没动 request_terminate_timeout，也没改 Nginx 的 fastcgi_read_timeout，结果 PHP 进程在 30 秒被强制 kill，Nginx 却还在等 60 秒 —— 最后报 upstream timed out (110: Connection timed out) while reading response header from upstream。
-
max_execution_time是 PHP 脚本层的软限制，可被set_time_limit()覆盖 -
request_terminate_timeout（php-fpm.conf）是硬杀进程的阈值，一旦触发会发SIGTERM，Nginx 收到Connection reset by peer或直接卡在 read header 阶段 -
fastcgi_read_timeout（nginx.conf）必须 ≥request_terminate_timeout，否则 Nginx 先超时，日志里就是upstream timed out
phpEnv 环境下必须核对的三组超时值
用 phpEnv 安装的 PHP-FPM，配置文件通常在 /usr/local/phpenv/versions/*/etc/php-fpm.d/www.conf；Nginx 配置则在 /usr/local/nginx/conf/vhost/*.conf 或全局 http 块。以下三组值必须形成“外大内小”的关系：
- Nginx 层：
fastcgi_read_timeout≥ 例如300（单位秒） - PHP-FPM 层：
request_terminate_timeout = 240（必须比 Nginx 小 10–30 秒，留出握手余量） - PHP 层：
max_execution_time = 210（再小一点，避免脚本自己提前退出导致响应不完整）
注意：fastcgi_connect_timeout 和 fastcgi_send_timeout 一般保持默认（5–10s）即可，除非你确认后端启动慢或请求体极大。
立即学习“PHP免费学习笔记（深入）”；
phpEnv 启动的 PHP-FPM 日志怎么查慢操作
phpEnv 不自带慢日志开关，需手动启用。编辑对应版本的 www.conf，取消注释并修改这两行：
slowlog = /usr/local/phpenv/versions/<your-version>/var/log/www.slow.log request_slowlog_timeout = 5s
然后重启 PHP-FPM：phpenv fpm restart。之后出现超时时，立刻执行：
tail -f /usr/local/phpenv/versions/<your-version>/var/log/www.slow.log
能看到具体卡在哪一行 PHP 代码、哪次 DB 查询或文件读写 —— 这比盲目调大 timeout 更有效。
容易被忽略的连接复用破坏点
即使超时参数全对齐，phpEnv + Nginx 仍可能因连接复用失效报 timeout。典型表现：错误偶发、$upstream_response_time 日志里出现大量 0.000 或极小值，但错误日志却是 reading response header。
- PHP-FPM 默认关闭 keepalive（
pm.max_requests=0时连接不复用），而 Nginx 默认开启fastcgi_keep_conn on；两者不匹配会导致连接被后端静默关闭后，Nginx 下次复用时报Connection reset by peer - 解决方案：在
www.conf中设pm.max_requests = 1000（避免进程无限运行导致连接老化），并在 Nginx location 块中显式关闭 keepalive：fastcgi_keep_conn off; - 或者反向统一：PHP-FPM 开启
pm.max_requests+ Nginx 保留fastcgi_keep_conn on，但必须确保request_terminate_timeout≤ 后端连接空闲关闭时间（如 nginx 的fastcgi_next_upstream_timeout无此参数，实际靠 TCP 层keepalive_timeout控制）
这个问题在 phpEnv 多版本共存环境下更隐蔽 —— 不同 PHP 版本的 www.conf 可能混用，务必逐个版本检查。
