用 client-go 创建 pod 必须显式设置 apiversion="v1" 和 kind="pod"，typemeta 不会自动填充；需正确初始化 rest.config 并构建 clientset；create 后 update 前须先 get 获取最新 resourceversion 或改用 patch。
用 client-go 创建 Pod 对象必须设置 apiVersion 和 kind
直接 new 一个 corev1.Pod 结构体还不够，Kubernetes API Server 要求每个资源对象必须带明确的类型标识。漏掉或写错 apiVersion（比如写成 v1 而不是 v1）会导致 400 Bad Request 错误，提示 the server could not find the requested resource。
正确做法是显式赋值：
pod := &corev1.Pod{
TypeMeta: metav1.TypeMeta{
Kind: "Pod",
APIVersion: "v1",
},
ObjectMeta: metav1.ObjectMeta{
Name: "demo-pod",
Namespace: "default",
},
Spec: corev1.PodSpec{
Containers: []corev1.Container{{
Name: "nginx",
Image: "nginx:1.25",
}},
},
}
-
Kind和APIVersion必须与 Go struct 类型严格对应；corev1.Pod对应的就是v1和Pod - 不要依赖默认零值——
TypeMeta字段不会自动填充，不设就是空字符串 - 如果用
unstructured.Unstructured动态创建，apiVersion和kind是 map 中的必需 key，拼写大小写敏感
调用 Create() 前必须初始化 rest.Config 并构建 Clientset
常见错误是直接 new 出 clientset 或硬编码 host/port，结果报 x509: certificate signed by unknown authority 或 connection refused。client-go 不会自动读取 kubeconfig，必须显式加载。
典型初始化流程：
cfg, err := rest.InClusterConfig() // Pod 内运行时
// 或
cfg, err := clientcmd.BuildConfigFromFlags("", "/path/to/kubeconfig") // 本地调试
if err != nil {
log.Fatal(err)
}
clientset, err := kubernetes.NewForConfig(cfg)
if err != nil {
log.Fatal(err)
}
- 在集群内运行时优先用
rest.InClusterConfig()，它会自动读取 ServiceAccount token 和 CA 证书 - 本地调试务必指定 kubeconfig 路径，
""表示不从环境变量读，避免误用默认路径 - 若使用自建 API Server 或私有集群，需手动设置
cfg.TLSClientConfig.Insecure = true（仅测试），生产环境必须配好 CA
Create() 返回对象含服务器生成字段，但 ResourceVersion 等不能直接用于后续 Update()
刚 Create() 出来的对象里 ResourceVersion、UID、CreationTimestamp 都是服务端写入的，但它们不是“活引用”——如果你拿这个对象原样改字段再 Update()，大概率触发 409 Conflict。
原因在于：Update 必须带当前最新 ResourceVersion，而 Create 返回的对象版本可能已被其他操作覆盖。
- 安全做法是：先
Get()拿最新版本，再修改，再Update() - 或者用
Patch()（推荐），避免全量提交和版本冲突，例如用types.MergePatchType更新 label - 注意
Update()要求对象的Name和Namespace字段非空，且不能改UID或ResourceVersion字段本身
删除资源时 Delete() 默认是异步的，要等实际消失得用 WaitForDelete()
调用 clientset.CoreV1().Pods("ns").Delete(ctx, "name", ...) 后，API Server 立即返回成功，但 Pod 可能还在 Terminating 状态。如果紧接着跑 e2e 测试或重建同名资源，容易遇到 AlreadyExists 或 NotFound 混淆。
client-go 自带等待工具，但不在 clientset 里，需额外引入：
err := wait.PollImmediate(1*time.Second, 30*time.Second, func() (bool, error) {
_, err := clientset.CoreV1().Pods("default").Get(ctx, "demo-pod", metav1.GetOptions{})
if apierrors.IsNotFound(err) {
return true, nil
}
return false, err
})
- 别自己写 for+sleep 循环，用
wait.PollImmediate更可靠 - 超时时间建议设为合理值（如 30 秒），避免测试卡死
- 如果只是清理测试资源，可以加
PropagationPolicy控制级联删除行为，比如设为metav1.DeletePropagationBackground
TypeMeta 不填就发不出去，ResourceVersion 不刷新就 Update 失败，这些细节不踩一遍坑很难记住。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
