Writing
Nginx 突然 502 Bad Gateway 怎么排查?从日志到修复全流程记录
记录一次完整的 Nginx 502 报错排查过程,包括查看 error_log、检查 PHP-FPM 状态、分析 socket 连接等具体操作,提供可直接执行的 Linux 命令和配置文件修改位置。
上周五晚上我的博客突然抽风,打开任何页面都显示 502 Bad Gateway,而当天既没改 Nginx 配置也没升级系统。这种毫无征兆的崩溃最让人头疼,被迫熬夜排查到凌晨 1 点。记录下完整的踩坑过程,下次遇到可以直接按这个 checklist 走一遍。
📌 本文摘要:Nginx 502 报错通常是后端服务(如 PHP-FPM)崩溃或连接超时导致。核心排查步骤包括:1) 查看 Nginx 的
error_log定位具体错误;2) 检查 PHP-FPM 进程是否存活;3) 确认 socket 文件权限和连接数限制;4) 调整fastcgi_read_timeout等参数。文中会给出 Ubuntu/Debian 下的具体命令和配置修改位置,适合 Linux 新手跟着操作。
下面是凌晨一点的完整作战记录:
第一步:看 Nginx 错误日志
Nginx 默认日志位置在 /var/log/nginx/error.log,直接用 tail 看最新报错:
# 查看最近 50 条错误日志(权限不够就加 sudo)
tail -n 50 /var/log/nginx/error.log
关键报错是下面这两行:
connect() to unix:/run/php/php8.1-fpm.sock failed (11: Resource temporarily unavailable)
fastcgi_pass 不可用
这明显是 Nginx 连不上 PHP-FPM 的 socket 文件了,可能原因有 3 种:
| 可能原因 | 检查方法 |
|---|---|
| PHP-FPM 进程崩溃 | systemctl status php8.1-fpm |
| socket 文件权限不对 | ls -l /run/php/php8.1-fpm.sock |
| 连接数超过限制 | `netstat -anp |
第二步:检查 PHP-FPM 状态
执行状态检查命令:
# 根据你的 PHP 版本调整(7.4/8.0/8.1等)
systemctl status php8.1-fpm
看到绿色的 active (running) 说明服务没挂,但是有更隐蔽的问题——所有 worker 进程都卡住了:
● php8.1-fpm.service - The PHP 8.1 FastCGI Process Manager
Loaded: loaded (/lib/systemd/system/php8.1-fpm.service)
Active: active (running) since Fri 2023-07-14 21:30:01 CST
CGroup: /system.slice/php8.1-fpm.service
├─ 1234 php-fpm: master process (/etc/php/8.1/fpm/php-fpm.conf)
├─ 5678 php-fpm: pool www
└─ 9012 php-fpm: pool www
第三步:确认 socket 连接数
用 netstat 看当前连接状态:
# 统计 PHP-FPM 的活跃连接数
netstat -anp | grep php-fpm | wc -l
我的服务器显示 256,而默认配置只有 150:
# 查看 PHP-FPM 最大连接数(在 pool 配置里)
grep "pm.max_children" /etc/php/8.1/fpm/pool.d/www.conf
解决方法有两个:
1. 临时增加连接数
编辑配置文件:
sudo nano /etc/php/8.1/fpm/pool.d/www.conf
找到并修改这两个参数:
pm.max_children = 300
pm.max_requests = 500
重启 PHP-FPM:
sudo systemctl restart php8.1-fpm
2. 优化 Nginx 超时设置
在 Nginx 的站点配置里增加:
location ~ \.php$ {
fastcgi_read_timeout 300;
fastcgi_send_timeout 300;
}
提示:如果你用的是 雨云,可以用优惠码
aabh升级配置,2核2G 的轻量云跑 WordPress 更稳。
第四步:检查文件权限(常见于搬家后)
如果 socket 文件权限不对,会看到类似错误:
connect() to unix:/run/php/php8.1-fpm.sock failed (13: Permission denied)
用这条命令修复:
sudo chown www-data:www-data /run/php/php8.1-fpm.sock
sudo chmod 660 /run/php/php8.1-fpm.sock
总结
遇到 502 别慌,按这个顺序查:
- 先看日志:
tail -n 50 /var/log/nginx/error.log - 检查服务状态:
systemctl status phpX.X-fpm - 数连接数:
netstat -anp | grep php-fpm | wc -l - 改配置:增加
pm.max_children或调整 Nginx 超时 - 查权限:确保 socket 文件属于 www-data 用户
个人经验:大多数 502 都是 PHP-FPM 连接数爆了,直接调大 pm.max_children 能应急,长期还是要优化代码或升级配置。