k8s-pod-terminating

Kubernetes Pod 卡在 Terminating 的定位与修复

现象

kubectl delete pod 后 Pod 长时间处于 Terminating，无法删除，也可能阻塞命名空间删除或节点维护。

快速定位

kubectl get pod <pod> -n <ns> -o yaml
kubectl describe pod <pod> -n <ns>
kubectl get pod <pod> -n <ns> -o jsonpath='{.metadata.finalizers}'
kubectl get events -n <ns> --sort-by=.lastTimestamp | tail -20

节点：

systemctl status kubelet
journalctl -u kubelet --since '30 min ago' | grep -i -E 'terminat|unmount|volume'

常见根因

1. finalizer 未清理，控制器没有完成收尾。
2. 卷卸载/删除卡住（CSI、云盘、NFS）。
3. 节点失联或 kubelet 不响应，状态无法回写。
4. 优雅终止时间过长，进程不退出。
5. 准入 Webhook 或命名空间控制器异常。

修复

• 先看 finalizers 和 Events，确认卡在卷、控制器还是 kubelet。
• 控制器问题修复后通常会自动继续；不要急着手工删 finalizer。
• 卷问题检查 CSI Pod、VolumeAttachment 和存储侧状态。
• 节点失联先恢复节点，或在确认安全后强制删除 Pod。
• --force --grace-period=0 是最后手段，可能留下孤儿资源。
• 对长期不退出进程调整 terminationGracePeriodSeconds 和信号处理。

相关命令

• kubectl — Pod 状态与事件
• journalctl — kubelet 日志
• crictl — 容器运行时