502错误核心线索是Nginx日志中“upstream prematurely closed connection”或“upstream timed out”,需结合php-fpm慢日志、错误日志及fastcgi_read_timeout与request_terminate_timeout匹配排查。
直接看
里的 upstream 错误行
502 出现时,Nginx 日志里几乎必然带
或
。这两条是核心线索,不是干扰项——前者说明
php
-fpm 进程主动断开了连接(大概率是执行超时或崩溃),后者说明 Nginx 等不到响应就放弃了(配置的 timeout 太短)。
执行命令快速定位:
重点盯住时间戳紧邻 502 请求的那几行,尤其是带
、
或具体 socket 路径(如
)的记录。
对比查
的慢日志和错误日志
Nginx 日志只告诉你“上游挂了”,但不知道为什么挂。必须同步检查 php-fpm 自己的日志:
立即学习
“
PHP免费学习笔记(深入)
”;
(错误类退出、致命报错)
(执行超过
的脚本)
如果 slow log 有内容,说明问题出在某个 PHP 脚本执行太久;如果 error log 里有
或
,那就是内存或段错误导致进程崩了。
确认 slow log 是否启用:
若没开,临时加上这两行再重载:
,
。
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑,通过深度错误修复、底层性能微调以及安全加固,旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范,不包含破坏性变更。
下载
和
必须匹配
这是最常被忽略的超时耦合点:Nginx 等 php-fpm 响应的时间,不能比 php-fpm 自己允许单个请求运行的时间还长,否则 Nginx 在 php-fpm 杀掉请求前就先报 502 了。
检查并确保:
Nginx 配置中 location 块内有
(单位秒)
PHP-FPM 配置
中有
PHP 自身的
(在
)
三者取最小值生效。如果只调高 Nginx 的
,但 php-fpm 仍设为 60s,那第 61 秒 php-fpm 就会杀掉进程,Nginx 收到 RST 后照样记一条
。
用
抓住 php-fpm 子进程卡在哪一秒
当慢日志没输出、error 日志也干净,但 502 持续发生,说明请求可能卡在系统调用层面(比如 DNS 解析阻塞、curl 外部接口 hang 住、数据库连接池耗尽)。这时需要抓现场:
先找到一个正在跑的 php-fpm worker 进程 ID:
然后用
跟它 10 秒:
复现一次 502 请求,立刻去看
最后几行——如果看到
卡住超过 5 秒,基本就是某次外部 HTTP 或 MySQL 连接没设 timeout 导致的。
/var/log/nginx/error.logupstream prematurely closed connectionupstream timed outtail -n 100 /var/log/nginx/error.log | grep "upstream\|502"php-fpmfastcgiunix:/tmp/php-cgi.sockphp-fpm/var/log/php-fpm/www-error.log/var/log/php-fpm/www-slow.logrequest_slowlog_timeoutchild exited on signal Segmentation faultAllowed memory size exhaustedgrep "slowlog\|request_slowlog_timeout" /www/server/php/74/etc/php-fpm.d/www.confslowlog = /var/log/php-fpm/www-slow.logrequest_slowlog_timeout = 5sfastcgi_read_timeoutrequest_terminate_timeoutfastcgi_read_timeout 300;/www/server/php/74/etc/php-fpm.d/www.confrequest_terminate_timeout = 300smax_execution_time = 300/www/server/php/74/etc/php.inifastcgi_read_timeoutupstream prematurely closedstraceps aux | grep "php-fpm: pool www" | head -n 1 | awk '{print $2}'stracestrace -p PID -T -tt -e trace=network,connect,sendto,recvfrom -s 100 -o /tmp/strace.log/tmp/strace.logconnect(…)