首页/网络/协议速查/502 Bad Gateway 网关错误
HTTP 方法与状态码91 条

502 Bad Gateway 网关错误

作为网关/代理的服务器从上游收到无效响应(或无法连接上游):上游崩溃、端口未监听、协议不匹配都可能触发。

协议速查网络更新于 2026-10-12
名称502 Bad Gateway
作用上游不可用/响应非法
规范RFC 9110 §15.6.3
常见根因后端进程挂了、连错端口、HTTP/HTTPS 协议不匹配、PHP-FPM 未启动

Nginx 快速排查上游状态

Nginx 快速排查上游状态
grep -E 'connect\(\) failed|upstream' /var/log/nginx/error.log | tail -20
ss -lntp | grep -E ':(8000|9000|3000)'   # 确认后端确实在监听
502 的第一现场在网关错误日志:connect() failed → 端口/进程问题;upstream sent invalid response → 协议问题。先读日志再改配置。

易错点

  • 后端 HTTP 服务配成 HTTPS 回源(或反之),日志显示 SSL 握手错误,却报给用户 502
  • 502 页面被 CDN 缓存住,后端恢复后用户仍看到旧错误页

数据来源与参考

  • RFC 9110 §15.6.3 502 Bad Gateway

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌