502 是 Nginx 返回的,不是 PHP 返回的
看到 502 Bad Gateway,先明确一点:这个状态码由 Nginx 自己生成,含义是"我连不上上游,或者上游提前断开了连接"。所以进程数正常、端口在监听,说明不了问题不存在。真正的线索在 error_log 里,它会写清是 connect() failed 还是 recv() failed。
第一步:盯住 error_log 里的三种句式
跟踪错误日志并复现一次,通常只有三类写法:
tail -f /var/log/nginx/error.log | grep -E "502|upstream|recv|connect"
# 典型输出
connect() to unix:/run/php-fpm/www.sock failed (13: Permission denied)
upstream prematurely closed connection while reading response header
recv() failed (104: Connection reset by peer)
connect() failed 说明根本连不上 FPM,方向是 socket 路径写错、权限不对、SELinux 拦截;prematurely closed 说明连上了但 PHP 中途退出,方向是脚本致命错误、内存耗尽、执行超时;recv() failed 多半是 worker 崩溃。
第二步:核对 socket 路径与运行用户
fastcgi_pass 与池配置里的 listen 必须完全一致,TCP 与 unix socket 混用是最常见的错配。用三条命令对照:
grep -r "fastcgi_pass" /etc/nginx/conf.d/
grep -E "^listen|^user|^group" /etc/php-fpm.d/www.conf
ls -l /run/php-fpm/www.sock
socket 的所有者必须和 Nginx worker 的运行用户匹配。若 Nginx 以 nginx 用户运行、socket 却属于 Apache,日志里就会出现 Permission denied,把池配置的 user 与 group 改成 nginx 即可恢复。
第三步:区分超时、崩溃还是进程池耗尽
日志显示 upstream timed out,说明 PHP 执行时间超过了 fastcgi_read_timeout,而不是 Nginx 本身慢。先看 PHP 慢日志定位脚本,再决定调大超时还是优化代码;盲目把 60 秒改成 300 秒,只是把问题藏起来。
另一个隐蔽原因是进程池被打满。pm.max_children 设得太小,请求排队后拿不到空闲 worker,同样返回 502。查看池状态:
curl "http://127.0.0.1/php-fpm-status?full"
ps -ef | grep "pool www" | wc -l
若 active processes 长期贴着 max_children,同时 listen queue 不为零,就该调大进程数或给 PHP 加缓存。
小结
排查顺序固定:先读 error_log 分清 connect、closed、timeout 三类,再核对 socket 路径与权限,最后看超时和进程池容量。按这个顺序走,多数 502 一次刷新就能定位到原因。
