client-go连接集群需区分环境：本地用kubeconfig文件配置，Pod内才用InClusterConfig；创建Deployment须用apps/v1版本并确保labels匹配；Watch需手动处理重连和resourceVersion；List需显式分页避免截断。
怎么用 client-go 连上你的集群
得先让 client-go 知道集群在哪、怎么认证。不是写个 rest.InClusterConfig() 就万事大吉——本地开发时它直接 panic，因为没 ServiceAccount token；用 rest.InClusterConfig() 前必须确认代码真跑在 Pod 里。
常见错误现象：invalid configuration: no configuration has been provided，或者 Unauthorized 却以为是地址写错了。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 本地调试优先用 kubeconfig 文件：
rest.InClusterConfig()换成clientcmd.BuildConfigFromFlags("", "/path/to/kubeconfig") - 若走环境变量（比如 CI），确保
KUBECONFIG已设，且文件可读；client-go不会自动 fallback 到~/.kube/config - 证书路径、server 地址、token 都得对得上——尤其自建集群常把
server写成内网 IP，但 client 在外网连不通
创建 Deployment 为什么总卡在 Pending 或报错 validation
Deployment 是最常用也最容易栽跟头的资源。问题常出在字段嵌套层级或版本不匹配，比如把 spec.template.spec.containers 写成 spec.containers，或者用了 apps/v1beta2（已废弃）却没改 client-go 版本。
使用场景：CI 脚本自动部署、Operator 中动态生成 workload。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 永远用
appsv1.Deployment类型（对应apps/v1API 组），别用extensions/v1beta1——K8s 1.16+ 已移除 -
spec.template.metadata.labels必须和spec.selector.matchLabels完全一致，漏一个 key 就ValidationError - 容器镜像名别带空格或特殊字符；
imagePullPolicy: Always在私有 registry 下容易因鉴权失败卡住拉取
Watch Deployment 状态变化却收不到事件
Watch 不是“监听”，而是长连接轮询式流式响应。一旦网络抖动、超时或服务端重置连接，watch 就断了——但 client-go 默认不会自动重连，你得自己处理 context.DeadlineExceeded 或 http.ErrUseOfClosedNetworkConnection。
性能影响：不设 ResourceVersion 会导致从头 list 全量再 watch，小集群还好，大集群可能 OOM。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
cache.NewInformer替代裸Watch，它自带重连、reflector 和本地缓存，省心很多 - 手动 Watch 时，每次断开后要拿最新
resourceVersion（从上一次响应的ObjectMeta.ResourceVersion取）重新发起请求 - 加
ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)，别用context.Background()直接传进Watch
List 所有 Pod 却只返回几十个，明明 namespace 里有几百个
client-go 默认分页，不显式传 Limit 就走服务端默认值（通常 500，但老版本可能是 100 或更少）。你以为 List 完了，其实只是第一页。
兼容性影响：K8s 1.22+ 强制要求分页参数，不带 Continue 字段的请求会被拒绝（400 Bad Request）。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 要么设大点的
Limit：listOptions.Limit = 1000，要么用Continue循环翻页 - 别手写分页逻辑，用
meta.ListOptions{Limit: 500}+continueToken字段迭代，client-go 提供了Pager封装 - 注意
FieldSelector（如status.phase=Running）可能和分页冲突，某些 K8s 版本下会忽略Limit
