K8s Pod 一直处于 Pending 状态排查指南

Pod 处于 Pending 状态，意味着尚未被调度到节点运行。排查时，请先区分是启动时 Pending 还是 运行后变为 Pending。

第一步：获取核心诊断信息

无论何种情况，首先执行以下命令查看具体原因（重点关注 Events 部分）：

kubectl describe pod <pod-name> -n <namespace>

如需核对配置细节，可导出 YAML 文件：

kubectl get pod <pod-name> -o yaml

第二步：根据场景定位问题

1. 启动时一直 Pending（调度失败）

• 资源不足：集群 CPU/内存无法满足 Pod 的 requests。
  • 排查：kubectl top nodes 或 kubectl describe node <node-name> 查看剩余资源。
• 污点与容忍不匹配：节点有 Taints，但 Pod 缺少对应的 Tolerations。
• 标签与亲和性限制：nodeSelector 或 affinity 规则过严，无匹配节点。
  • 排查：kubectl get nodes --show-labels 对比节点标签。
• PVC 未绑定：存储卷未就绪导致 Pod 等待。

2. 运行一段时间后变为 Pending（节点异常）

• 磁盘满或资源耗尽：节点触发驱逐机制，Pod 被迫重新调度。
• 节点不可用：节点宕机、网络断开或被手动隔离（cordon）。
  • 排查：kubectl get nodes 检查节点是否处于 Ready 状态。

常用排查命令速查

• 看事件详情：kubectl describe pod <pod-name>
• 看完整配置：kubectl get pod <pod-name> -o yaml
• 看节点负载：kubectl top nodes
• 看节点资源：kubectl describe node <node-name>
• 看节点状态：kubectl get nodes