terminating-stuck

Pod 一直 Terminating

现象

删除 Pod 后状态长期停留在 Terminating，kubectl delete 不返回或超时；节点上容器可能已停止，但 API 对象仍在。

快速定位

kubectl get pod <POD> -n <NS> -o yaml
kubectl describe pod <POD> -n <NS>
kubectl get pod <POD> -n <NS> -o jsonpath='{.metadata.finalizers}'

查看 kubelet 和运行时：

crictl ps -a | grep <POD>
journalctl -u kubelet --since '30 min ago' | grep <POD>

常见根因

• 有 finalizer 没有对应的控制器处理。
• Pod 卡在卷卸载或网络清理。
• kubelet 无响应或节点 NotReady。
• 优雅终止时间过长，进程不响应 SIGTERM。
• 准入 webhook 或 API 请求被阻塞。
• 节点已删除，Pod 对象残留。

修复

• 确认 finalizer 的作用，修复对应控制器后再删除。
• 调小 terminationGracePeriodSeconds，让进程处理 SIGTERM。
• 重启 kubelet 或修复节点。
• 节点已不存在时，用 kubectl delete pod --force --grace-period=0 清理。
• 检查 VolumeAttachment 和挂载残留。
• 不要批量强制删除，先确认数据和安全影响。

相关命令

• kubectl get pod -o yaml — finalizer 和状态
• kubectl delete pod --force — 强制删除
• crictl — 容器状态
• journalctl -u kubelet — kubelet 日志
• kubectl get volumeattachment — 卷挂载