kubernetes服务不可用最常见的原因是labels不匹配或port配置错误；deployment的spec.selector.matchlabels与pod模板的metadata.labels必须完全一致（含大小写），且selector字段不可变，修改会报错field is immutable。
Go 程序能直接部署进 Kubernetes，但 Service 配置错一个字段，服务就根本收不到流量 —— 最常见的失败不是镜像问题，而是 labels 不匹配或 port 写错。
Deployment 的 labels 和 selector 必须严格一致
这是 80% 的“服务访问不了”问题的根源。Kubernetes 不会自动帮你对齐，写错一个字母、多一个空格、少一个 label 字段，Service 就找不到 Pod。
-
spec.selector.matchLabels和template.metadata.labels的键值对必须完全相同（包括大小写） - 如果 Deployment 中写了
matchLabels: {app: "api", env: "prod"}，那 Pod 模板里labels也必须包含这两个 key，缺一不可 - 修改已有 Deployment 的 labels 时，
spec.selector是不可变字段，Kubernetes 会直接拒绝更新，报错：field is immutable - 调试方法：用
kubectl get pods -l app=api,env=prod看是否能列出来；再用kubectl get endpoints go-service看SUBSETS是否有地址 —— 空就是没匹配上
containerPort、targetPort、port 三者容易混淆
Service 流量路径是：外部 → Service.port → Service.targetPort → Pod.containerPort。这三个端口不一定要相同，但必须逻辑连通。
-
containerPort是 Go 程序实际监听的端口，比如http.ListenAndServe(":8080", nil)→ 这里必须写8080 -
targetPort是 Service 转发到 Pod 的端口，可以是数字（如8080）或名称（如"http"），但必须和容器内暴露的端口一致 -
port是 Service 自己暴露的端口，比如设成80，那集群内其他服务访问http://go-service:80才能通 - 常见错误：
targetPort: 80但 Go 监听的是:8080→ 连接被拒绝；或者containerPort: 8080没写，Kubernetes 就不认为该端口开放，健康检查可能失败
Service 类型选 ClusterIP 还是 NodePort？别硬编码
硬写 Type: LoadBalancer 在本地集群（kind/minikube）里永远等不到 EXTERNAL-IP，而写死 NodePort: 30080 又容易和他人冲突或超出范围（默认 30000–32767）。
- 开发/调试阶段一律用
ClusterIP+kubectl port-forward service/go-service 8080:80，最稳 - CI 流水线部署测试环境，用
NodePort，但不要指定具体端口号，让 Kubernetes 自动分配（删掉nodePort字段） - 生产环境上云才用
LoadBalancer，且必须配合云厂商注解（如service.beta.kubernetes.io/aws-load-balancer-type），不能只靠 type 字段 - Go 代码里不要轮询
service.Status.LoadBalancer.Ingress等 IP 就绪 —— 它可能延迟数分钟，应由运维侧通过 Ingress 或 DNS 控制流量切入时机
readinessProbe 和 livenessProbe 必须分离且指向不同路径
共用一个 /healthz 是最危险的配置：Pod 启动中，livenessProbe 就开始猛刷，导致反复重启，永远进不了 Ready 状态。
-
livenessProbe指向/healthz：只检查进程是否卡死，返回 200 即可，不连 DB、不查依赖 -
readinessProbe指向/readyz：必须真实检查下游，比如db.Ping()、redis.Conn().Ping()，任一失败就返回 503 - 务必设置
initialDelaySeconds: 5（给 Go 服务 bind 端口留时间）和failureThreshold: 3（避免 GC STW 误判） - Go 服务里要显式注册这两个 handler，别漏掉
http.HandleFunc("/readyz", readyHandler)，否则 probe 全是 404
真正卡住人的从来不是“怎么写 YAML”，而是 label 对不上、port 配错、probe 路径没实现、或者在本地跑通了就以为 Service 一定通 —— Kubernetes 的 Service 是独立资源，它不关心你的 Go 进程有没有 listen，只认 labels 和 ports。动手前先 kubectl get endpoints 看一眼，比重试十次 deployment 有用得多。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
