手机与微信同号,长按或点击号码即可复制微信号添加咨询
结论:502 表示网关收不到上游程序的回应,不是「网站程序报错」,所以先看进程和连接数,不要一上来就翻代码。五分钟内能判断的是三件事:是间歇还是持续、是全站还是单页、PHP-FPM 进程是否还活着。2026 年我们处理过的 502 里,按比重排前三的是 PHP-FPM 进程耗尽、上游超时设置过短、以及服务器内存被占满触发 OOM。
HTTP 502 的正式含义是网关或代理从上游收到无效响应。你的架构里,上游可能是 PHP-FPM、Node 进程、也可能是另一台后端服务器。这个定位很关键:502 说明请求已经到了网关,但没等到正常回包。
分不清这三者,排查方向就会完全跑偏。曾经有客户把 502 当程序 bug 改了两天代码,最后发现是 PHP-FPM 的进程池被慢查询占满。
故障形态决定了排查路径。用浏览器和一个命令行工具各访问两次,基本就能归类。
| 现象 | 最可能的原因 | 先查什么 | 处置方向 |
|---|---|---|---|
| 间歇性 502,刷新几次能好 | 进程池被打满,慢请求堆积 | FPM 慢日志、当时的并发数 | 加进程数、加超时、优化慢查询 |
| 全站 502,一直不恢复 | PHP-FPM 未启动或端口不通 | 进程是否存在、端口是否监听 | 启动服务、看启动报错 |
| 只有某个页面 502 | 该页执行超时或内存超限 | 该页的错误日志、执行耗时 | 拆查询、加大内存上限 |
| 上传或导出时 502 | 请求体过大或执行时间超限 | 网关的 body 限制、超时配置 | 调大 client_max_body_size |
| 换服务器后立刻 502 | 路径、权限或 PHP 版本不一致 | 新机的 FPM 配置与目录权限 | 对齐配置、重载服务 |
不需要登录服务器也能先做前两项。检查顺序按「从外到内」走,能少走很多弯路。
第三步和第四步的日志位置因环境而异,找不到就先确认站点跑在 Nginx 还是 Apache 下。运维基础可参考网站维护基础知识,建站上线后的运维工作。
确定了大致方向,再按层往下推。每一层只回答一个问题,不要跳层。
五层里最常见的是第四层。一个没加索引的列表查询在数据涨到十万行后要跑 40 秒,把进程池占满,表现就是全站间歇 502,而错误日志里只有「上游超时」这一句。
| 根因 | 典型表现 | 处置动作 | 是否要停机 |
|---|---|---|---|
| PHP-FPM 进程耗尽 | 间歇 502,晚高峰明显 | 按内存核算后上调进程数,或拆池 | 需要重载 |
| 慢查询堆积 | 某页面慢,随后全站 502 | 加索引、改分页、加缓存 | 不需要 |
| 内存不足触发 OOM | 进程莫名消失,系统日志有记录 | 扩内存或限制单进程内存 | 需要重启 |
| 上游超时设置过短 | 固定时长后必然 502 | 把超时调到大于最慢请求 | 需要重载 |
| 磁盘写满 | 日志停写、上传失败 | 清日志、加盘、配轮转 | 不需要 |
| 数据库连接数打满 | 并发一高就 502 | 加连接池、查长连接泄漏 | 视情况 |
重启能解决 502,但会掩盖问题。判断标准是:这次重启是为了恢复服务,还是为了查原因。
一条纪律:每次重启前先备份当前日志。恢复服务和保留证据不冲突,多花 30 秒的事。
502 恢复之后,真正的价值在复盘。补上下面三件事,同类故障的恢复时间能从小时级压到分钟级。
如果 502 出现在换服务器或迁移之后,先怀疑配置没对齐,迁移的检查项见网站搬家换服务器要注意什么?迁移步骤与停机时间控制。要从访问记录里区分真实用户和爬虫造成的流量尖峰,方法见网站日志怎么看?从访问记录识别爬虫与异常流量。
结论:不是,502 说明服务器还在,只是没拿到程序的正常响应。绝大多数情况是进程池满了、程序卡住或超时,硬件故障占比很低。先看 PHP-FPM 进程是否存活、listen queue 是否堆积,比换服务器有效。
结论:502 是上游返回了无效响应或连接被断开,504 是网关等上游响应超时。前者多是进程没起或崩溃,后者多是程序执行太慢。两者经常同时出现,因为慢请求既可能超时,也可能把进程占满导致后续请求连不上。
结论:重启服务类故障 5 分钟内能恢复,慢查询或容量问题通常要 1-4 小时。恢复时间取决于是否能立刻定位到根因。有监控和日志留存的项目,平均恢复时间在 30 分钟以内;没有任何日志的项目,往往要数小时。
结论:把进程容量、慢查询、超时配置三项纳入日常巡检。具体做法是每月看一次慢查询 Top 10,按内存核算进程数上限,并把网关超时设成大于最慢请求的 1.5 倍。做到这三条,502 从「常态故障」变成「偶发事件」。
13560189272
地址:广州市天河区信成南街侨景大厦2楼201房(华阳小学正门正对面)