go语言不管理微服务，kubernetes负责编排与生命周期控制；go通过client-go与api交互，需确保namespace、labels、clientset配置正确，多阶段构建优化镜像，探针配置匹配进程模型，service端口与selector严格一致。
Go 语言本身不管理微服务，Kubernetes 才是真正负责编排、扩缩容、服务发现和生命周期控制的系统；Go 的角色是写好服务本身，并通过 client-go 与 Kubernetes API 对话——比如创建 Deployment、监听 Pod 状态、或实现 Operator。关键不是“用 Go 控制 Kubernetes”，而是让 Go 程序成为 Kubernetes 生态里可被调度、可观测、可自愈的一等公民。
Deployment 创建失败：Namespace、Labels 和 ClientSet 配置漏项
最常见错误不是代码逻辑错，而是资源归属没对齐。比如用 rest.InClusterConfig() 在本地调试时直接 panic，或忘记给 Deployment 设置 Namespace 字段，导致对象被创建到 default 而非目标命名空间。
-
ClientSet.AppsV1().Deployments(namespace)中的namespace必须显式传入，不能依赖结构体里的ObjectMeta.Namespace—— 后者只影响资源元数据，不决定 API 路径 - Label selector（
matchLabels）必须与 Pod template 的labels完全一致，否则 Deployment 无法关联任何 Pod，Replicas 始终为 0 - 本地开发建议用
rest.InClusterConfig()+kubeconfig文件 fallback，例如：if os.Getenv("KUBERNETES_SERVICE_HOST") == "" { config, _ = clientcmd.BuildConfigFromFlags("", "/path/to/kubeconfig") }
容器镜像体积大、启动慢：多阶段构建没做对
一个未优化的 Go 镜像可能超 800MB，而精简后可压到 12MB 左右。问题不在 Go 编译本身，而在 Dockerfile 没分离构建环境和运行时环境。
针对 Kubernetes 仪表板和 Web UI 的浏览器自动化。适用于与 Kubernetes Dashboard、Grafana、ArgoCD UI 或其他 Web 界面交互。需要设置 MCP_BROWSER_ENABLED=true。
- 第一阶段用
golang:1.21-alpine构建，第二阶段必须用纯alpine:latest或scratch，且仅COPY --from=builder二进制文件，不带/usr/local/go或go.mod - 编译时加
-ldflags="-s -w"去除调试符号和 DWARF 信息，体积通常减少 30%～40% - 避免在最终镜像中
RUN apk add ca-certificates—— alpine 默认已含，重复安装会增大层数
Pod 启动后立即 CrashLoopBackOff：探针与进程模型不匹配
Go 服务常因 livenessProbe 配置不当被误杀。典型现象是日志显示服务已 listen，但几秒后被 kubelet 重启。
-
livenessProbe.httpGet.path必须返回 HTTP 200，且 handler 不能阻塞 —— 若用http.ListenAndServe后没加 goroutine，整个进程会卡住，probe 根本发不出 -
initialDelaySeconds要大于服务冷启动耗时（如 DB 连接、配置加载），Go 应用一般设为 10～15 秒较安全 - 不要在
readinessProbe里检查外部依赖（如 Redis 是否连通），这会导致服务永远 not ready；应只检查自身监听端口是否就绪
Service 无法访问 Pod：端口映射与 selector 错位
Service 类型选 ClusterIP 却从集群外 curl 不通，或 NodePort 显示 Endpoints 为空，基本都是端口或 label 没对上。
-
Service.spec.ports[].targetPort必须等于 Pod container 的containerPort数值或名称，若写成字符串名（如"http"），则 container 必须有对应name: http -
Service.spec.selector和 Deployment 的spec.selector.matchLabels必须完全一致 —— 多一个空格、少一个字母都会导致 Endpoints 为<none></none> - 在 Pod 内用
curl http://my-service:8080能通，但宿主机用curl <node-ip>:<node-port></node-port></node-ip>不通，先确认节点防火墙是否放行该端口（尤其云厂商默认关闭 NodePort 范围）
最容易被忽略的是 finalizer 处理 —— 当你用 Go 写 Operator 或自定义控制器时，若没在 Reconcile 中正确处理 metadata.finalizers，删除 CR 会卡在 Terminating 状态。这不是语法错误，而是 Kubernetes 对象生命周期契约的一部分，必须显式清理资源并移除 finalizer 才算完成。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
