502 Bad Gateway 问题解决指南

TONY · 发表于 2026-5-7 10:02

出现 502 Bad Gateway 报错时，一般表现为浏览器显示“502 Bad Gateway”或“服务器暂时不可用”，页面内容加载失败，通常在几秒到几分钟内可能自动恢复。这种错误意味着服务器之间的通信出了岔子，但别担心，按下面步骤一步步排查就能找到根子。
【可能原因】

【排查步骤】

检查上游服务是否正常运行
登录服务器，执行
1. systemctl status your-service
复制代码
或
1. ps aux | grep php-fpm
复制代码
，确认应用进程状态。如果有 crash，看日志（如
1. /var/log/php-fpm/error.log
复制代码
）。
查看代理服务器错误日志
Nginx 错误日志一般在
1. /var/log/nginx/error.log
复制代码
，Apache 在
1. /var/log/httpd/error_log
复制代码
。搜索“upstream timed out”或“connect() failed”等关键词。
检测服务器资源使用情况
运行
1. **
复制代码
、
1. free -m
复制代码
、
1. df -h
复制代码
，观察 CPU 和内存是否接近 100%。如果内存吃紧，可能是 PHP 进程泄漏或并发太高。
测试端口连通性
用
1. telnet 127.0.0.1 9000
复制代码
（例如 PHP-FPM 端口）检查能否连接。若失败，检查防火墙：
1. iptables -L -n
复制代码
或
1. ufw status
复制代码
。
检查应用超时设置
查看 Nginx
1. proxy_read_timeout
复制代码
、
1. fastcgi_read_timeout
复制代码
是否过短，以及 PHP
1. max_execution_time
复制代码
是否够用。超时会引起 502 并丢出对应日志。

【最终解决方案】

服务崩溃：重启服务（
1. systemctl restart nginx && systemctl restart php-fpm
复制代码
），同时修复代码中的死循环或内存泄漏。
负载过高：临时增加服务器实例数或升级配置，同时在应用层加入限流（如 Nginx
1. limit_req
复制代码
）。
防火墙问题：开放对应内部端口，例如
1. ufw allow 9000
复制代码
或**组添加入站规则。
配置文件错误：修正 proxy_pass 中的 IP/端口，并检查 upstream 后端是否可用。
超时太短：适当延长
1. proxy_read_timeout 60s
复制代码
、
1. max_children
复制代码
等参数，然后平滑重载配置。

搞定这些后，刷新页面应该就能看到正常内容了。如果还不行，仔细看日志中的具体报错行，再去搜索引擎里贴那段错误信息，基本就能药到病除。