首页/云/云与容器速查/Service/Ingress 502/504 排查
本包目录(340 条)

Service/Ingress 502/504 排查

网关层 502/504 大多不是网关自己坏了:502 常是后端端口不通/进程崩,504 是后端超时。按 入口→Service→Endpoints→Pod 链路逐层缩小范围。

云与容器速查云更新于 2026-10-12
502 含义网关连不上后端或收到非法响应
504 含义后端处理超时(网关在等)
第 1 看Endpoints 是否为空:空=选择器/就绪问题
第 2 看Pod 端口是否监听:exec ss -lntp 或 port-forward 直连
第 3 看Ingress 注解与路径重写:规则错会 404 而非 502/504

链路排查

链路排查
kubectl get endpoints web -n dev
kubectl port-forward svc/web 8080:80 -n dev &
curl -si http://127.0.0.1:8080/ | head -5
kubectl logs -n ingress-nginx deploy/ingress-nginx-controller --tail=50 | grep -i error
port-forward 直连能通而域名 502:问题在 Ingress/网关层;两者都不通:问题在应用或 Service 定义。

易错点

  • 先怀疑网关重启 Ingress:真实原因多半在 Endpoints 或探针
  • 504 直接加超时时间:慢查询/死锁没解决,只是把故障拖长

数据来源与参考

  • Kubernetes Docs:Service
  • ingress-nginx 文档:Troubleshooting

相关工具

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