DevToolPal
简
5xx 服务器错误

502 Bad Gateway

网关错误

含义

网关或代理从它转发请求的上游服务器收到了无效响应。

常见原因

  • 应用服务器崩溃或没有在监听(端口或 socket 错误)
  • 上游关闭了连接或发送了格式错误的响应头
  • PHP-FPM、Gunicorn 或 Node 进程重启

解决方法

客户端或访问者

稍等片刻后重试;通常是暂时的。如果持续出现,说明网站后端已宕机。

网站或 API 的维护者

检查上游进程是否在运行并监听代理所使用的地址,并查看代理的错误日志了解具体的上游错误。

响应示例

HTTP/1.1
HTTP/1.1 502 Bad Gateway
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Type: text/html
Content-Length: 0

规范

RFC 9110 §15.6.3

常见问题

› 如何解决 nginx 中的 502 Bad Gateway?

检查上游(应用是否在运行、proxy_pass 地址/socket 是否正确)和 nginx 错误日志;如果应用服务器崩溃就重启它。

› 502 和 504 的区别?

502:上游返回了无效内容或关闭了连接。504:上游没有及时回应。