1. 简介
在 Kubernetes 中，命名空间（Namespace）有时会卡在 Terminating 状态，无法正常删除。造成这一现象的原因可能包括：
- 存在未清理的资源（hanging resources）
- finalizers 未被正确处理
- 外部依赖（如某些 CRD 或云服务资源）未释放
虽然我们可以强制删除命名空间，但建议先排查具体原因，避免误删或掩盖潜在问题。
2. 排查卡住的命名空间
在尝试强制删除之前，我们应先查看命名空间的状态：
$ kubectl get ns <namespace>
为了获取更详细的信息，可以使用 -o yaml 查看完整结构：
$ kubectl get ns <namespace> -o yaml
✅ 重点关注输出中的 conditions 字段，它可能提示命名空间卡住的原因。
如果 conditions 没有帮助，我们可以尝试列出该命名空间下的所有资源：
$ kubectl api-resources --verbs=list --namespaced=true -o name \
| xargs -n 1 kubectl get --ignore-not-found --show-kind -n <namespace>
如果发现有残留资源，第一步应尝试手动删除这些资源。
❌ 如果没有发现资源，可以检查命名空间下的事件日志：
$ kubectl events -n <namespace>
还可以通过 --type=Warning 过滤出警告类事件，帮助定位问题：
$ kubectl events -n <namespace> --type=Warning
✅ 事件日志通常能提供命名空间无法删除的线索。
如果仍然无法定位问题，可以进一步查看 kube-controller-manager 的日志：
$ kubectl get pods -o name -n kube-system | grep controller-manager | xargs -n 1 kubectl logs -n kube-system
⚠️ 该命令会输出 controller manager 的日志，注意查找与目标命名空间相关的条目。
3. 强制删除卡住的命名空间
如果上述排查均未发现问题，或者你已经确认可以安全强制删除命名空间，可以通过以下方式操作：
✅ 方法一：使用 kubectl edit 删除 finalizers
$ kubectl edit ns <namespace>
在编辑器中找到 metadata.finalizers 字段，并将其清空或设置为 null：
metadata:
finalizers: null
保存并退出编辑器，Kubernetes 会继续完成命名空间的删除流程。
✅ 方法二：使用 kubectl patch 快速清除 finalizers
$ kubectl patch ns <namespace> -p '{"metadata":{"finalizers": null }}'
这个命令会直接将命名空间的 finalizers 清空，从而跳过所有清理步骤。
✅ 确认删除成功的方法：
$ kubectl get ns <namespace>
如果返回类似如下错误，则说明命名空间已成功删除：
Error from server (NotFound): namespaces "<namespace>" not found
4. 总结
本文介绍了 Kubernetes 中命名空间卡在 Terminating 状态的常见原因，并提供了排查与解决方法：
- ✅ 首先通过
kubectl get ns -o yaml、kubectl events、kubectl api-resources等命令排查资源残留或事件异常 - ❌ 如果排查无果，再考虑强制删除
- ✅ 强制删除可通过
kubectl edit或kubectl patch清除 finalizers 实现
⚠️ 注意：强制删除命名空间可能导致残留资源无法自动清理，建议在确保无影响的前提下操作。
如果你在实际操作中遇到其他异常情况，也欢迎留言交流。