用 client-go 创建 Service 对象需先构造 v1.Service 结构体，正确填充 ObjectMeta（Name、Namespace、Labels）和 Spec（Selector、Ports、Type），再调用 clientset.CoreV1().Services(namespace).Create() 提交。
用 client-go 创建 Service 对象要先构造 v1.Service 结构体
Go 程序里创建 Kubernetes Service，本质是调用 API Server 的 POST /api/v1/namespaces/{namespace}/services 接口，client-go 封装了这个过程。关键不是“发请求”，而是正确填充 v1.Service 字段——尤其 Spec.Selector 和 Spec.Ports 必须匹配后端 Pod 标签和容器端口，否则 Service 不会路由流量。
常见错误是直接复制 YAML 字段名（比如写 selector: map[string]string{"app": "myapp"}），但 Go struct 字段名首字母大写且有 tag，必须按 v1.Service{Spec: v1.ServiceSpec{Selector: map[string]string{"app": "myapp"}}} 方式赋值。
-
Meta.Name和Meta.Namespace必须非空，否则 API 返回name is required -
Spec.Type建议显式设为v1.ServiceTypeClusterIP、v1.ServiceTypeNodePort或v1.ServiceTypeLoadBalancer，不依赖默认值 -
Spec.Ports中每个v1.ServicePort至少要填Port（Service 暴露端口）和TargetPort（Pod 容器端口），后者可以是 int（如8080）或 string（如"http"），但必须与 Pod spec 中 container port 名称或端口号一致
调用 clientset.CoreV1().Services(namespace).Create() 才真正提交
构造好结构体后，必须用 clientset 发起 Create 请求，仅构造 struct 不会触发任何集群变更。注意返回值是 *v1.Service（含 API Server 分配的 UID、CreationTimestamp 等），不是 error 就算成功；error 为 nil 但 .Status.Conditions 为空也不代表就绪，Service 就绪需等 Endpoints 同步（可通过 watch Endpoints 判断）。
- 命名空间错写成
"default "（尾部空格）会导致namespaces "default " not found - 如果集群 RBAC 拒绝权限，会收到
Forbidden: services is forbidden，需确保 ServiceAccount 绑定roles.rbac.authorization.k8s.io或自定义 Role 允许createonservices - 并发创建同名 Service 会报
AlreadyExists错误，应捕获并处理，而非 panic
用 Apply 替代 Create 更适合配置即代码场景
如果程序目标是“让集群状态等于代码定义”，而不是“新建一个资源”，Apply（通过 server-side apply）比 Create 更健壮：它能自动处理已存在资源的更新，避免重复创建失败，也减少手动判断逻辑。
立即学习“go语言免费学习笔记（深入）”；
启用 server-side apply 需 client-go v0.22+ 且 kube-apiserver 开启 ServerSideApply feature gate（1.22+ 默认开启）。调用方式是 clientset.CoreV1().Services(namespace).Apply(ctx, serviceApply, metav1.ApplyOptions{FieldManager: "my-controller"})，其中 serviceApply 是 *types.ApplyConfiguration 类型，由 applyconfigurations 包生成。
- 不用手写 ApplyConfiguration —— 运行
go run k8s.io/code-generator/cmd/applyconfiguration-gen可批量生成 -
FieldManager名字要固定（如用控制器名），否则不同 manager 写同一字段会冲突 - Apply 不会删除字段，只覆盖声明的字段；想清空某字段（如 selector），必须显式设为
nil或空 map
本地调试时 rest.InClusterConfig() 会失败，改用 rest.InClusterConfig() 或 clientcmd.BuildConfigFromFlags()
在集群外运行（如本地 IDE 或 CI）时，rest.InClusterConfig() 因找不到 /var/run/secrets/kubernetes.io/serviceaccount/token 而 panic。此时必须加载 kubeconfig 文件，用 clientcmd.BuildConfigFromFlags("", kubeconfigPath) 构造 config。
-
kubeconfigPath设为""会读默认路径$HOME/.kube/config，但硬编码路径不跨平台，建议通过 flag 或环境变量传入 - 若 kubeconfig 使用 exec 插件（如 gke、eks 登录），需确保执行环境已安装对应二进制且有权限，否则
exec: executable aws not found - config 构造后务必调用
rest.SetKubernetesDefaults()补全默认 group/version，否则可能报no kind "Service" is registered
Service 创建看似简单，但 Selector 匹配、RBAC 权限、kubeconfig 加载、Apply vs Create 语义差异这四点，几乎覆盖了 90% 的实际报错原因。别只盯着 Create 调用是否返回 error，得确认 Endpoints 是否生成、NodePort 是否分配、ExternalIPs 是否就绪——这些都得查 API，不是 client-go 一行代码能包办的。
