Writing

Nginx 突然 502 Bad Gateway 怎么排查?从日志到修复全流程记录

记录一次完整的 Nginx 502 报错排查过程,包括查看 error_log、检查 PHP-FPM 状态、分析 socket 连接等具体操作,提供可直接执行的 Linux 命令和配置文件修改位置。

· 8 分钟阅读
目录
  1. 第一步:看 Nginx 错误日志
  2. 第二步:检查 PHP-FPM 状态
  3. 第三步:确认 socket 连接数
  4. 1. 临时增加连接数
  5. 2. 优化 Nginx 超时设置
  6. 第四步:检查文件权限(常见于搬家后)
  7. 总结

上周五晚上我的博客突然抽风,打开任何页面都显示 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 别慌,按这个顺序查:

  1. 先看日志:tail -n 50 /var/log/nginx/error.log
  2. 检查服务状态:systemctl status phpX.X-fpm
  3. 数连接数:netstat -anp | grep php-fpm | wc -l
  4. 改配置:增加 pm.max_children 或调整 Nginx 超时
  5. 查权限:确保 socket 文件属于 www-data 用户

个人经验:大多数 502 都是 PHP-FPM 连接数爆了,直接调大 pm.max_children 能应急,长期还是要优化代码或升级配置。

相关文章