首页/云/Kubernetes 速查/kubectl 连不上集群先查什么
集群运维与排障54 条

kubectl 连不上集群先查什么

报 connection refused、i/o timeout 或证书错误时,先区分是本地 kubeconfig/证书问题还是控制面不可用,两者的检查点不同。

Kubernetes 速查云更新于 2026-10-12

先分辨

先分辨
kubectl config current-context
kubectl config view --minify
kubectl cluster-info
curl -k https://10.0.0.10:6443/healthz      # 仅排查用途,-k 跳过证书校验
x509: certificate has expired → 客户端证书过期或 CA 变更;connection refused → apiserver 未监听或被拦截;i/o timeout → 网络路径或负载均衡问题。

易错点

  • 直接删掉 ~/.kube/config:先备份并确认根因,证书过期重签更常见
  • 忽略系统时间:时钟偏差过大会导致 TLS 校验与证书有效期判断异常

数据来源与参考

  • Kubernetes 官方文档 · 访问集群与 healthz 端点
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌