×

咨询热线 / 微信咨询

手机与微信同号,长按或点击号码即可复制微信号添加咨询

莫小姐
客户经理
18026225625
微信同号 · 点击复制
莫小姐微信二维码
司徒先生
客户经理
13560189272
微信同号 · 点击复制
司徒先生微信二维码
咨询热线:18026225625(莫小姐) · 13560189272(司徒先生)
已复制
技术知识
NEWS CENTRE
首页
>
新闻中心
>
网站突然报502错误怎么办?从网关到PHP的排查顺序

网站突然报502错误怎么办?从网关到PHP的排查顺序

2026-11-10 阅读:121

结论:502 表示网关收不到上游程序的回应,不是「网站程序报错」,所以先看进程和连接数,不要一上来就翻代码。五分钟内能判断的是三件事:是间歇还是持续、是全站还是单页、PHP-FPM 进程是否还活着。2026 年我们处理过的 502 里,按比重排前三的是 PHP-FPM 进程耗尽、上游超时设置过短、以及服务器内存被占满触发 OOM。

一、502 是「上游没回应」,不是网站程序报错

HTTP 502 的正式含义是网关或代理从上游收到无效响应。你的架构里,上游可能是 PHP-FPM、Node 进程、也可能是另一台后端服务器。这个定位很关键:502 说明请求已经到了网关,但没等到正常回包。

  • 可能是网关到上游的连接被拒(进程没起、端口没监听)。
  • 可能是上游接了连接但不回包(进程卡死、数据库锁等待、外部接口超时)。
  • 可能是上游回包但被判定无效(响应头异常、内容被截断)。
  • 与 500 的区别:500 是程序跑了并抛错,502 是程序根本没跑完。
  • 与 504 的区别:504 是等超时,502 是没等到有效响应就断了。

分不清这三者,排查方向就会完全跑偏。曾经有客户把 502 当程序 bug 改了两天代码,最后发现是 PHP-FPM 的进程池被慢查询占满。

二、先分清三类 502:间歇、全站、单页

故障形态决定了排查路径。用浏览器和一个命令行工具各访问两次,基本就能归类。

现象最可能的原因先查什么处置方向
间歇性 502,刷新几次能好进程池被打满,慢请求堆积FPM 慢日志、当时的并发数加进程数、加超时、优化慢查询
全站 502,一直不恢复PHP-FPM 未启动或端口不通进程是否存在、端口是否监听启动服务、看启动报错
只有某个页面 502该页执行超时或内存超限该页的错误日志、执行耗时拆查询、加大内存上限
上传或导出时 502请求体过大或执行时间超限网关的 body 限制、超时配置调大 client_max_body_size
换服务器后立刻 502路径、权限或 PHP 版本不一致新机的 FPM 配置与目录权限对齐配置、重载服务

三、五分钟内能做的四项检查

不需要登录服务器也能先做前两项。检查顺序按「从外到内」走,能少走很多弯路。

  • 看是否全站:首页和任意内页各刷两次,全站 502 优先怀疑服务未起。
  • 看响应头:带 Server 头的多半是网关直接返回,说明请求根本没到程序。
  • 看进程:登录后执行进程查看命令,确认 PHP-FPM 或应用进程是否存活、数量是否异常。
  • 看系统日志:内存溢出记录、磁盘是否写满,这两项会直接让进程被杀。

第三步和第四步的日志位置因环境而异,找不到就先确认站点跑在 Nginx 还是 Apache 下。运维基础可参考网站维护基础知识,建站上线后的运维工作。

四、按层排查:网关 → 进程 → 应用

确定了大致方向,再按层往下推。每一层只回答一个问题,不要跳层。

  • 网关层:Nginx 的 error.log 里会有明确的上游连接失败记录,关键词是 connect failed 或 upstream timed out。
  • 进程层:PHP-FPM 的 status 页能看 active、idle、listen queue 三项,listen queue 持续大于 0 就是进程不够。
  • 配置层:fastcgi_read_timeout 默认 60 秒,接口慢的项目经常在这个点上断。
  • 应用层:慢查询日志和框架自己的日志,重点看故障时间点前后有没有同一条 SQL 反复出现。
  • 依赖层:数据库连接数是否打满、Redis 是否连不上、第三方接口是否超时。

五层里最常见的是第四层。一个没加索引的列表查询在数据涨到十万行后要跑 40 秒,把进程池占满,表现就是全站间歇 502,而错误日志里只有「上游超时」这一句。

五、常见根因与对应处置

根因典型表现处置动作是否要停机
PHP-FPM 进程耗尽间歇 502,晚高峰明显按内存核算后上调进程数,或拆池需要重载
慢查询堆积某页面慢,随后全站 502加索引、改分页、加缓存不需要
内存不足触发 OOM进程莫名消失,系统日志有记录扩内存或限制单进程内存需要重启
上游超时设置过短固定时长后必然 502把超时调到大于最慢请求需要重载
磁盘写满日志停写、上传失败清日志、加盘、配轮转不需要
数据库连接数打满并发一高就 502加连接池、查长连接泄漏视情况

六、什么时候该重启,什么时候别重启

重启能解决 502,但会掩盖问题。判断标准是:这次重启是为了恢复服务,还是为了查原因。

  • 该重启:进程已经僵死、服务起不来、内存被占满,先把服务拉回来再查。
  • 该重启:配置改完必须重载才生效,这类重启是计划内的。
  • 别急着重启:间歇 502 但服务还活着,重启会清掉现场,日志和连接状态全丢。
  • 别只重启:同一问题一周内重启三次以上,说明根因没找到,必须做慢查询和容量分析。

一条纪律:每次重启前先备份当前日志。恢复服务和保留证据不冲突,多花 30 秒的事。

七、事后要补的三件事

502 恢复之后,真正的价值在复盘。补上下面三件事,同类故障的恢复时间能从小时级压到分钟级。

  • 监控:加一个 1 分钟频率的可用性探测,别等客户打电话才知道站挂了。
  • 日志留存:网关、FPM、应用三层日志至少留 7 天,并且时间要同步。
  • 预案:写清谁负责、先看哪个日志、什么情况下扩容,贴在运维文档里。

如果 502 出现在换服务器或迁移之后,先怀疑配置没对齐,迁移的检查项见网站搬家换服务器要注意什么?迁移步骤与停机时间控制。要从访问记录里区分真实用户和爬虫造成的流量尖峰,方法见网站日志怎么看?从访问记录识别爬虫与异常流量。

常见问题

网站报502是服务器坏了吗?

结论:不是,502 说明服务器还在,只是没拿到程序的正常响应。绝大多数情况是进程池满了、程序卡住或超时,硬件故障占比很低。先看 PHP-FPM 进程是否存活、listen queue 是否堆积,比换服务器有效。

502 和 504 有什么区别?

结论:502 是上游返回了无效响应或连接被断开,504 是网关等上游响应超时。前者多是进程没起或崩溃,后者多是程序执行太慢。两者经常同时出现,因为慢请求既可能超时,也可能把进程占满导致后续请求连不上。

502 一般多久能恢复?

结论:重启服务类故障 5 分钟内能恢复,慢查询或容量问题通常要 1-4 小时。恢复时间取决于是否能立刻定位到根因。有监控和日志留存的项目,平均恢复时间在 30 分钟以内;没有任何日志的项目,往往要数小时。

怎么避免 502 反复出现?

结论:把进程容量、慢查询、超时配置三项纳入日常巡检。具体做法是每月看一次慢查询 Top 10,按内存核算进程数上限,并把网关超时设成大于最慢请求的 1.5 倍。做到这三条,502 从「常态故障」变成「偶发事件」。

相关内容

13560189272
地址:广州市天河区信成南街侨景大厦2楼201房(华阳小学正门正对面)
COPYRIFHT © 2010-2020 广州市名联网络科技有限公司 ALL RIGHTS RESERVED 粤ICP备10203057号
  • 这里是二维码