502 Bad Gateway 排查指南

502 = Nginx（或反代）联系不上后端服务。顺着这条链路查，5 分钟内基本能定位。

排查顺序

  1. 后端进程还活着吗
    systemctl status php8.*-fpm（WordPress）或你的应用服务。挂了先 journalctl -u 服务名 -n 50 看崩溃原因。
  2. 端口对得上吗
    Nginx 配置里的 fastcgi_pass / proxy_pass 指向的端口，要与进程实际监听一致：ss -tlnp | grep 9000。
  3. 是碰巧还是必现
    偶发 502 多为后端超时或重启瞬间；必现多为配置错误或进程没起来。
  4. 资源打满了吗
    free -h 看内存（OOM 会杀掉 PHP-FPM 子进程），df -h 看磁盘满没满。
  5. 防火墙/安全组
    后端在另一台机器时，确认安全组放行了反代 IP 的访问端口。

高频原因速查表

现象大概率原因
更新插件后立刻 502PHP 内存超限 php.ini memory_limit
流量高峰期间歇 502PHP-FPM 进程数不足 pm.max_children
全新配置必现 502proxy_pass 地址/端口写错、.sock 路径不对
服务器重启后 502后端服务未设开机自启 systemctl enable

更多故障排查（SSL 错误、DNS 不生效、网站迁移）持续更新中。需要帮助可通过 首页表单 提交咨询。