含义
网关或代理从它转发请求的上游服务器收到了无效响应。
常见原因
- 应用服务器崩溃或没有在监听(端口或 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 规范
常见问题
› 如何解决 nginx 中的 502 Bad Gateway?
检查上游(应用是否在运行、proxy_pass 地址/socket 是否正确)和 nginx 错误日志;如果应用服务器崩溃就重启它。
› 502 和 504 的区别?
502:上游返回了无效内容或关闭了连接。504:上游没有及时回应。