Nginx报502 Bad Gateway完整排查思路（PHP-FPM场景）

前言

502 Bad Gateway 是 Nginx 最常见的报错之一，尤其是 LNMP 架构下，Nginx 把 PHP 请求转发给 PHP-FPM，PHP-FPM 出问题了 Nginx 就报 502。本文讲一下完整的排查思路。

502 是什么意思

502 表示 Nginx 作为反向代理，去请求后端服务（PHP-FPM）的时候，后端没响应或者报错了。

注意： 502 不是 Nginx 的问题，是后端 PHP-FPM 的问题。

排查步骤

第一步：检查 PHP-FPM 服务是否在运行

systemctl status php-fpm

如果显示 inactive (dead)，说明 PHP-FPM 挂了，启动它：

systemctl start php-fpm
systemctl enable php-fpm

第二步：检查 Nginx 和 PHP-FPM 的通信配置

看 Nginx 配置里的 fastcgi_pass 对不对：

grep fastcgi_pass /etc/nginx/nginx.conf

常见的配置：

# 用 socket 文件
fastcgi_pass unix:/run/php-fpm/www.sock;

# 用 TCP 端口
fastcgi_pass 127.0.0.1:9000;

问题1：socket 文件路径不对

Nginx 配置里写的 socket 路径和 PHP-FPM 实际的不一致。

PHP-FPM 的 socket 路径在 /etc/php-fpm.d/www.conf 里：

grep listen /etc/php-fpm.d/www.conf

确保两边路径一致。

问题2：端口被占

如果用 9000 端口，检查一下是不是被别的进程占了：

lsof -i:9000

第三步：看错误日志

Nginx 错误日志：

tail -f /var/log/nginx/error.log

PHP-FPM 错误日志：

tail -f /var/log/php-fpm/error.log

PHP 慢日志：

tail -f /var/log/php-fpm/www-slow.log

根据日志里的报错信息找原因。

第四步：常见原因

原因1：PHP-FPM 进程数不够

访问量大的时候，PHP-FPM 进程都被占满了，新请求排队超时。

解决： 增加 PHP-FPM 进程数。

编辑 /etc/php-fpm.d/www.conf：

pm.max_children = 50
pm.start_servers = 20
pm.min_spare_servers = 10
pm.max_spare_servers = 30

改完重启：

systemctl restart php-fpm

原因2：PHP 脚本执行超时

PHP 脚本执行时间太长，超过了 Nginx 的超时时间。

解决： 调大超时时间。

Nginx 配置里：

fastcgi_connect_timeout 300;
fastcgi_send_timeout 300;
fastcgi_read_timeout 300;

PHP 配置里：

max_execution_time = 300

原因3：PHP 内存不足

PHP-FPM 进程内存溢出，导致进程崩溃。

解决： 调大 PHP 内存限制：

memory_limit = 256M

或者减少 PHP-FPM 进程数，避免内存不够。

原因4：文件权限不对

Nginx 运行的用户和 PHP-FPM 运行的用户不一致，导致 PHP-FPM 读不到文件。

解决： 确保 Nginx 和 PHP-FPM 用同一个用户（一般是 www）。

PHP-FPM 配置 /etc/php-fpm.d/www.conf：

user = www
group = www

然后把网站文件的属主改成 www：

chown -R www:www /var/www/html

第五步：重启所有服务

改完配置后重启：

systemctl restart php-fpm
systemctl restart nginx

常见坑

坑1：只重启了 Nginx

改了 PHP 配置但只重启了 Nginx，PHP-FPM 还是老配置。

解决： PHP 配置改了要重启 PHP-FPM，Nginx 配置改了要重启 Nginx。

坑2：socket 文件权限不对

PHP-FPM 的 socket 文件权限是 600，Nginx 用户读不到。

解决： 改 socket 文件权限：

listen.mode = 0666

或者改 socket 文件的属主：

listen.owner = www
listen.group = www

坑3：PHP-FPM 挂了但没自动重启

PHP-FPM 进程崩溃了，没人自动拉起来。

解决： 配置 systemd 自动重启：

systemctl edit php-fpm

加：

[Service]
Restart=always
RestartSec=2

总结

502 排查步骤：

1. 先看 PHP-FPM 是不是挂了 → systemctl status php-fpm
2. 再看 Nginx 配置对不对 → fastcgi_pass 路径/端口
3. 看错误日志 → Nginx error.log + PHP-FPM error.log
4. 常见原因 → 进程数不够、超时太短、权限不对、内存不足

记住：502 问题出在后端，不是 Nginx 的锅。

遇到问题加QQ23979811 协助处理