502 Bad Gateway(网关错误)

502 Bad Gateway(网关错误)是一个 HTTP 状态码,表示充当网关或反向代理的服务器在转发请求时,从上游服务器收到了无效的响应,因而无法完成本次请求。

概述

现代网站很少由单台服务器直接对外服务,通常会在前面架设一层网关——例如 Nginx 反向代理、负载均衡器或 CDN 节点。用户的请求先到达网关,再由网关转发给后端真正处理业务的服务器。当后端返回的内容不合法,或者后端根本没有正常响应时,网关就会向用户返回 502 Bad Gateway 页面。

HTTP 状态码的标准由 IETF 在 RFC 文档中定义,并由 IANA 统一维护登记。502 属于 5xx 系列,这一系列都表示服务器一侧出错;与之相对,404 等 4xx 系列表示客户端请求本身有问题。因此看到 502 时,责任基本在网站方,普通访客能做的事情很有限。

对访客而言,可以刷新页面、清理缓存、换个网络或稍后再试;如果多次尝试仍然 502,基本可以确定是网站故障,等待站方修复即可。

对站长而言,应先确认后端服务进程是否存活、监听端口是否与网关配置一致,再查看网关与应用的错误日志定位原因;若是过载导致,则需要重启服务、优化性能或扩容。使用宝塔面板、Nginx 等自建网站时,502 多半出在 PHP-FPM 停止运行或代理端口写错这类细节上。

问:502 是我的电脑或网络坏了吗?答:一般不是。502 属于服务器端错误,多数情况是网站后端故障;换设备、换网络仍报 502,就只能等网站方修复。

问:502 和 500、504 有什么区别?答:500 是服务器内部通用错误;502 是网关收到了上游的无效响应;504 是网关等待上游超时没等到响应。三者都属于 5xx,但指向的环节不同。

问:自建网站频繁出现 502 怎么办?答:优先检查后端应用(如 PHP-FPM、Node 服务)是否崩溃或内存不足,再核对反向代理的目标地址和端口,并结合错误日志判断是配置问题还是性能瓶颈。