使用 clientset 必须先配置有效的 rest.Config，否则会 panic；常见来源包括本地 kubeconfig、InClusterConfig 和手动构造；命名空间不能为空且需符合 RFC 1123 规范；Watch 需带 ctx 和重连逻辑；CRD 应用 DynamicClient 并注意类型安全。
用 clientset 连接集群必须配置 rest.Config
直接 new 一个 clientset 是无效的，它不接受空配置。你得先拿到有效的 rest.Config，否则会 panic 或报 no configuration has been provided 错误。
常见来源有三种：
- 本地
kubeconfig文件（开发/调试）：用clientcmd.BuildConfigFromFlags("", kubeconfigPath)，第二个参数为空字符串表示用默认路径（$HOME/.kube/config） - Pod 内运行（生产环境）：用
rest.InClusterConfig()，它从/var/run/secrets/kubernetes.io/serviceaccount/自动加载 token 和 CA - 手动构造（极少用）：比如对接非标准 API server 地址，需显式设置
Host、BearerToken、TLSServerName和CAFile
注意：rest.InClusterConfig() 在非 Pod 环境下会返回 open /var/run/secrets/...: no such file or directory，别硬套。
clientset.CoreV1().Pods(namespace) 的 namespace 不能为空
几乎所有资源操作都要求明确指定 namespace，传 "" 不代表 “所有命名空间”，而是触发单 namespace 模式下的默认命名空间（通常是 default）。想跨 namespace 查 pod？得用 clientset.CoreV1().Pods("").List() 并传入 metav1.ListOptions{FieldSelector: "metadata.namespace!=kube-system"} 这类过滤，但更推荐分 namespace 轮询。
立即学习“go语言免费学习笔记（深入）”；
容易踩的坑：
- 误把
""当作通配符，结果只查到default下的资源 - 在
Namespace字段里填了非法字符（如大写字母、下划线），Kubernetes 会返回Invalid value: "MyNs": a lowercase RFC 1123 label must consist of lower case alphanumeric characters... - 用
clientset.CoreV1().Pods("default").Get(ctx, "my-pod", metav1.GetOptions{})时，如果 pod 不在default，错误是NotFound，不是权限或连接问题
Watch 资源时别漏掉 ctx 和重连逻辑
Watch 是长连接，底层依赖 HTTP/1.1 的 chunked response 或 HTTP/2 stream。一旦网络抖动或 server 关闭连接，watch 就会中断，且 watch.Interface 不自动重连。
正确做法是用循环 + 指数退避重试：
for {
w, err := clientset.CoreV1().Pods("default").Watch(ctx, opts)
if err != nil {
time.Sleep(backoff)
backoff = min(backoff*2, 30*time.Second)
continue
}
defer w.Stop()
for event := range w.ResultChan() {
// 处理 event.Object
}
}
关键点：
-
ctx必须带超时或取消信号，否则 watch goroutine 可能永远卡住 -
opts.ResourceVersion应设为上一次 watch 结束时的LastSyncResourceVersion，避免事件丢失；首次可设为"0" - Kubernetes 默认关闭 watch 缓存（
resourceVersion=""），若要确保一致性，不要省略ResourceVersion
使用 DynamicClient 处理 CRD 时类型信息不能靠猜
clientset 只支持内置资源（Pod、Service 等）。CRD 需用 dynamic.Interface，但它返回的是 *unstructured.Unstructured，字段全在 Object["spec"] 这种 map 里，没有结构体校验。
这意味着：
- 写错字段名不会编译报错，运行时才 panic：
panic: interface conversion: interface {} is nil, not map[string]interface{} - 无法用
json.Marshal直接序列化未初始化的Object["spec"]，得先判空再取值 - 建议搭配
scheme.Scheme.Convert()或自定义 struct +json.Unmarshal做二次解析，尤其当 CRD spec 较复杂时
真正难处理的不是怎么调用，而是怎么让 unstructured 数据流不破坏你已有的类型安全边界——这点在大型 Operator 中最容易被忽略。
