连接失败主因是认证配置错误：集群内用 rest.InClusterConfig()，外部须用 clientcmd.BuildConfigFromFlags 加载 kubeconfig 绝对路径；Deployment 的 selector 与 template labels 必须一致，replicas 需用 pointer.Int32(3)，镜像必须显式带 tag；应用应使用 controller-runtime client.Apply 实现幂等；Pod 崩溃需查 events、强制 log flush、静态编译二进制。
用 client-go 连接 Kubernetes 集群失败怎么办
绝大多数连接问题不是代码写错，而是认证配置没对上。client-go 不会自动读取 kubectl 的当前上下文，必须显式提供 rest.Config。
- 本地开发时，优先用
rest.InClusterConfig()—— 但仅限 Pod 内运行；外部调用必须用rest.InClusterConfig()会 panic，得换rest.InClusterConfig()（错误！正确是rest.InClusterConfig()仅用于集群内，外部请用rest.InClusterConfig()？不，是rest.InClusterConfig()错了——实际该用rest.InClusterConfig()？停，纠正：外部连接应调用rest.InClusterConfig()？不对。正确路径是：rest.InClusterConfig()仅适用于 Pod 内；外部请用rest.InClusterConfig()？彻底混乱了。
重说：外部连接唯一可靠方式是加载 kubeconfig 文件：
config, err := clientcmd.BuildConfigFromFlags("", "/path/to/.kube/config")
if err != nil {
log.Fatal(err)
}
常见坑："" 表示不指定 API server 地址（从 config 文件里读），第二个参数必须是绝对路径；若用 os.Getenv("KUBECONFIG")，注意它可能为空或含多个路径（用冒号分隔），clientcmd.BuildConfigFromFlags 不支持，得用 clientcmd.NewNonInteractiveDeferredLoadingClientConfig。
创建 Deployment 时字段填错导致 Apply 失败
Deployment 的 spec.selector.matchLabels 和 spec.template.metadata.labels 必须完全一致，否则 API Server 拒绝创建，报错类似：error: invalid spec.selector: invalid label selector: unable to parse requirement: expected ']', got 'EOF' 或更隐蔽的 field is immutable（改了 selector 后再 apply 就触发）。
立即学习“go语言免费学习笔记（深入）”；
-
spec.replicas类型是*int32，不能直接写3，得用func() *int32 { i := int32(3); return &i }()或更简洁的pointer.Int32(3)（需引入k8s.io/utils/pointer） - 容器镜像名别漏写 tag，默认是
:latest，但生产环境必须显式指定，否则滚动更新无法感知变更 -
spec.template.spec.containers[].ports[].containerPort必须是整数，且name字段若存在，必须符合 DNS-1123 标准（小写字母、数字、短横线，最长 15 字符）
用 Apply 替代 Create 实现幂等部署
直接调 clientset.AppsV1().Deployments(ns).Create() 在重复执行时会报 AlreadyExists 错误。真正在 CI/CD 中落地，得模拟 kubectl apply 行为：先 Get，不存在则 Create，存在则 Patch。
但手动写 merge patch 很容易出错。推荐用 sigs.k8s.io/controller-runtime/pkg/client（比原生 client-go 更高阶）：
import "sigs.k8s.io/controller-runtime/pkg/client"
c, _ := client.New(config, client.Options{})
dep := &appsv1.Deployment{...}
if err := c.Patch(context.TODO(), dep, client.Apply, client.FieldOwner("my-app")); err != nil {
// 处理错误
}
注意：client.Apply 底层依赖服务器端 Apply（Server-Side Apply），Kubernetes v1.22+ 默认启用；若集群较老，得确认 apply.directories feature gate 是否开启，否则 fallback 到客户端计算 patch（易冲突）。
Pod 启动后立即 Crash，怎么快速定位
Go 程序在容器里挂掉，日志往往来不及刷到 stdout 就退出，kubectl logs 看不到任何输出。根本原因是 Go 的 log 默认缓冲，且容器启动失败时标准流可能未 flush。
- 启动时加
GODEBUG=madvdontneed=1环境变量（避免某些内核下 mmap 内存回收异常） - 在 main 函数开头强制设置：
log.SetOutput(os.Stdout); log.SetFlags(log.LstdFlags | log.Lshortfile) - 用
kubectl describe pod查Events区域，重点关注FailedCreatePodContainer、BackOff、CrashLoopBackOff对应的 message - 如果程序因 configmap/secrets 加载失败而 panic，确保 init container 或 volume mount 已就绪；用
kubectl get events -n按时间倒序看最近事件--sort-by=.lastTimestamp
最常被忽略的一点：Go binary 编译时没加 -ldflags="-s -w" 去符号表，导致 Alpine 镜像里运行时报 no such file or directory（实际是动态链接器找不到，因为默认用 glibc，而 Alpine 用 musl）——务必用 CGO_ENABLED=0 go build 静态编译。
