Kubernetes Pod CrashLoopBackOff 报 statuscode 503 Liveness probe 超时怎么排查

现象:Pod 一直 CrashLoopBackOff

Kubernetes 部署一个 Go 服务,Pod 状态一直是 CrashLoopBackOff,describe pod 里看到 Liveness probe failed: HTTP probe failed with statuscode: 503。Pod 启动后健康检查一直没通过,重启次数飙到 10 次以上。

根因一:探针路径或端口不对

Liveness probe 默认访问 8080 端口的 /healthz,但你的服务可能监听 3000 端口或 /api/health。配置错了 probe 永远通不过,K8s 就一直重启 Pod。

# 错误:默认配置,服务实际监听 3000 端口
livenessProbe:
  httpGet:
    path: /healthz
    port: 8080

# 正确:按服务实际配置
livenessProbe:
  httpGet:
    path: /api/health
    port: 3000
  initialDelaySeconds: 15   # 服务启动慢就多等会
  periodSeconds: 10
  failureThreshold: 3

根因二:启动太慢,探针先挂了

服务启动要 30 秒,但 initialDelaySeconds 设成了 5 秒,探针跑过来时服务还没监听端口。这种情况把 initialDelaySeconds 调大到 服务启动时间 + 10 秒,或者给 readinessProbe 一个更长的宽松配置。

# 先禁用 Liveness 只留 Readiness,等 Pod ready 再重启试试
livenessProbe: null
readinessProbe:
  httpGet:
    path: /api/health
    port: 3000
  initialDelaySeconds: 30  # 够服务启动了

排查命令

先看 Pod 日志看应用自己报什么错。curl 进 Pod 内部手动请求探针路径,确认服务正常。如果 Pod 一直重启进不去,用 kubectl debug 开个调试容器。

kubectl describe pod my-app-pod
kubectl logs my-app-pod --previous   # 上一次启动的日志
kubectl exec -it my-app-pod -- curl http://localhost:3000/api/health
kubectl debug my-app-pod -it --image=busybox  # 调试容器

总结:CrashLoopBackOff 报 503 十有八九是 Liveness probe 的路径或端口配错了,或者 initialDelaySeconds 太短服务没启动完。先看 describe pod 里的 Events,再进 Pod 内部手动 curl 探针路径确认。

您可以还会对下面的文章感兴趣: