fishzzz

宝塔面板网站报 502 Bad Gateway:原因和逐项排查

服务器与运维更新于 约 1500 字

502 的意思是:Nginx 收到了访客的请求,转给后面的 PHP 或者其他服务,结果对方没有正常回应。所以要查的不是 Nginx,而是它后面的那个服务

502 的排查顺序
  1. 看 Nginx 日志error.log 里的 upstream 报错
  2. 查 PHP 服务进程是否在、socket 是否存在
  3. 查进程和内存子进程是否用满、是否被 OOM 杀
  4. 查超时慢请求是否超过 fastcgi 超时
  5. 查防火墙规则WAF 或 CC 防护是否返回错误
  6. 查 CDN 回源回源地址、端口和协议

先看 Nginx 错误日志

宝塔的 Nginx 错误日志在网站设置的「日志」里,或者直接看 /www/wwwlogs/网站名.error.log。502 时一般会有这几种报错

日志里的关键句说明
connect() to unix:/tmp/php-cgi-74.sock failedPHP 服务没运行,或者 socket 文件不在
upstream prematurely closed connectionPHP 进程处理到一半崩溃或者被杀了
upstream timed outPHP 处理太久,超过了超时时间(这种通常是 504)
no live upstreams反向代理的后端全部不可用

PHP 服务没在运行

在宝塔的「软件商店」里看对应 PHP 版本是否显示已启动,或者命令行运行

ps aux | grep php-fpm
ls -l /tmp/php-cgi-*.sock

没在运行就先重启。如果重启后很快又挂了,看 PHP-FPM 自己的日志(/www/server/php/74/var/log/php-fpm.log),常见原因

  • 配置文件被改坏,启动失败
  • 装了不兼容的扩展,比如装 redis 扩展时版本不对
  • 网站切换了 PHP 版本,但 Nginx 配置里引用的还是旧版本的 socket

进程不够用或者被系统杀掉

网站时好时坏、访问量大的时候 502,多半是 PHP 子进程用满了。PHP-FPM 日志里会出现 server reached pm.max_children setting

但也不能无脑调大。每个 PHP 进程占 30 到 100MB 内存,进程数开太多会把内存吃光,系统开始杀进程(OOM)。我处理过好几台服务器都是这种情况,而且最先被杀的往往是 MySQL,网站从 502 变成「数据库连接错误」

检查是否发生过 OOM

dmesg -T | grep -i "killed process"

合理的设置:可用内存除以单个 PHP 进程平均内存,得到 max_children 的上限,再给 MySQL 留出足够内存。另外 pm.max_spare_servers 不能大于 max_children,否则 PHP-FPM 根本启动不了

请求太慢,被超时中断

某些页面特别慢(大量数据导出、外部接口调用、数据库慢查询),超过 Nginx 的 fastcgi_read_timeout 或 PHP 的 max_execution_time 后被中断。日志里是 timed out,浏览器显示 504 或 502

先找出是哪个页面慢、为什么慢,而不是一味把超时调长。临时可以把超时调到 120 秒,同时排查慢的原因

防火墙或 WAF 返回的错误

宝塔的 Nginx 防火墙、CC 防护触发时,有时不是返回 403 页面,而是直接断开连接或者返回自定义状态码。经过 CDN 或 Cloudflare 时,访客看到的就变成了 502 或 520

我遇到过一个案例:网站频繁出现 520 错误,查到最后是宝塔防火墙的一个配置文件里把触发规则后的响应写死成了直接断开连接,正常访客访问稍微频繁就被断开。排查方法

  • 在宝塔防火墙的拦截日志里搜访客的 IP
  • 临时关闭网站的防火墙规则,看错误是否消失
  • 把 CDN 的回源 IP 段加入白名单,避免 CDN 节点被当成攻击者封掉

网站接了 CDN 的情况

CDN 报 502 时还要查回源这一段

  • 回源地址和端口是否正确,源站是否开放了对应端口
  • 回源协议:源站只有 80 端口却配置了 HTTPS 回源,或者源站证书过期
  • 回源 Host 是否是网站的域名

直接用源站 IP 访问网站(在本地 hosts 文件里把域名指向源站 IP)可以判断问题在源站还是在 CDN

排查完的预防

  • 设置 PHP 和 MySQL 异常退出后自动拉起
  • 内存小的服务器加 swap,并调低 MySQL 被系统杀掉的优先级
  • 宝塔的计划任务里加一个简单的检测脚本,网站返回 502 时自动重启 PHP 并记录时间

502 反复出现找不到规律的,可以把错误日志发我看看

把情况发我,先免费看一眼

不用先付钱。我看完直接告诉你问题在哪、能不能做、要多久

先免费判断改动前完整备份工程师本人对接淘宝担保交易

周一至周日 09:00 – 22:00

每天 09:00 – 22:00 在线

微信二维码扫码加微信fishzzz233 淘宝店铺二维码手机淘宝扫码平台担保交易

先免费判断,再决定做不做每天 09:00 – 22:00 · 一般 1 小时内回复

淘宝下单平台担保交易