安全创建命名空间需先用Get()检查是否存在，再调用Create()；若Create()报errors.IsAlreadyExists(err)，应忽略该错误。
Namespace.Create() 会报 AlreadyExists 错误，怎么安全创建？
直接调用 Create() 创建命名空间时，若名称已存在，会返回 errors.IsAlreadyExists(err) 为 true 的错误，而不是静默忽略。这不符合“幂等创建”需求。
- 必须显式检查错误类型，不能只看
err != nil - 推荐用
Get()先查是否存在，再决定是否Create()；或直接捕获IsAlreadyExists -
CreateOptions中不支持设置“如果存在则跳过”，没有类似FieldManager或Force参数
示例判断逻辑：
_, err := clientset.CoreV1().Namespaces().Create(ctx, ns, metav1.CreateOptions{})
if err != nil {
if errors.IsAlreadyExists(err) {
fmt.Printf("Namespace %s already exists\n", ns.Name)
return nil
}
return err
}
Update Namespace 只能改 Labels 和 Annotations，其他字段会报错
Namespace 是少数不允许更新大部分字段的资源之一。Kubernetes API 明确限制：除 Labels、Annotations 和 Finalizers 外，其余字段（如 Name、Spec、Status）在 Update() 时会被拒绝，返回 Invalid 错误（HTTP 422）。
-
ObjectMeta.ResourceVersion必须携带，否则报Conflict；通常从上次Get()或List()结果中取 - 修改
Labels时，整个 map 会被全量替换，不是 patch 式合并 - 想改
Finalizers（比如移除kubernetes.io/pv-protection）需谨慎，可能阻塞删除
正确更新写法：
立即学习“go语言免费学习笔记（深入）”；
ns, _ := clientset.CoreV1().Namespaces().Get(ctx, "my-ns", metav1.GetOptions{})
ns.Labels["updated"] = "true"
_, err := clientset.CoreV1().Namespaces().Update(ctx, ns, metav1.UpdateOptions{})
Delete() 默认是异步级联删除，但不会等 namespace 真的消失
CoreV1().Namespaces().Delete() 提交后立即返回，底层触发的是异步清理流程：先置 Status.Phase = Terminating，再逐个删除该 namespace 下所有资源（Pod、Service、Deployment 等），最后才真正移除 Namespace 对象本身。
- 不传
DeleteOptions时，默认使用Background传播策略，最快但不可控 - 若需等待终结完成，得轮询
Get()直到返回NotFound错误（errors.IsNotFound(err)） - 加
PropagationPolicy: &metav1.DeletePropagationForeground可让 API Server 阻塞直到子资源开始终止，但依然不保证 namespace 已消失
常见误判：
// ❌ 错误认为 Delete() 返回就代表删除成功
clientset.CoreV1().Namespaces().Delete(ctx, "test-ns", metav1.DeleteOptions{})
<p>// ✅ 正确做法：轮询确认
for i := 0; i < 60; i++ {
_, err := clientset.CoreV1().Namespaces().Get(ctx, "test-ns", metav1.GetOptions{})
if errors.IsNotFound(err) {
break // 确认已删干净
}
time.Sleep(2 * time.Second)
}
Namespace.List() 返回的 Phase 字段才是真实状态，别只看 Name
Namespace 有三种可能的 Status.Phase：Active、Terminating、Pending（后者极少出现）。仅靠 List() 返回的 Name 列表无法判断该命名空间是否可用——比如一个正在被删除的 namespace 仍会出现在 List() 结果里，直到彻底清理完毕。
- 批量操作前务必检查
ns.Status.Phase == corev1.NamespaceActive -
Terminating状态下对它做Create/Update会失败，且多数子资源已不可见 - 某些旧版集群（Status，需兼容性处理：先判
ns.Status.Phase != ""
安全遍历示例：
list, _ := clientset.CoreV1().Namespaces().List(ctx, metav1.ListOptions{})
for _, ns := range list.Items {
if ns.Status.Phase == corev1.NamespaceActive {
fmt.Println("Usable:", ns.Name)
}
}
实际写代码时最容易漏掉的是：没处理 ResourceVersion 导致 Update() 失败，以及把 Delete() 当同步操作用而没轮询确认。这两个点一旦出问题，自动化脚本就会在看似成功的情况下留下残留或误判状态。
