Kubernetes中Go服务需显式绑定0.0.0.0:PORT，且代码端口、containerPort、探针port、targetPort四者必须严格一致；健康路径须真实返回200，配置须通过环境变量或挂载注入并注意大小写与权限。
Go代码里端口和监听地址必须显式写死0.0.0.0
Go服务在Kubernetes里起不来，八成是http.ListenAndServe绑错了地址。本地用":8080"能跑，是因为开发机上localhost默认解析到127.0.0.1；但Pod内网络是独立命名空间，127.0.0.1只通本容器，Ingress控制器、kubelet探针全连不上。
正确做法只有两个：
- 直接写
http.ListenAndServe("0.0.0.0:8080", nil) - 或从环境变量读取并强制绑定：
port := os.Getenv("PORT"); if port == "" { port = "8080" }; http.ListenAndServe("0.0.0.0:"+port, nil)
别信“Go会自动适配”，它不会。哪怕你用net/http包，也得自己写清楚0.0.0.0。
Deployment中containerPort和探针port必须严格对齐
containerPort不是装饰字段，它是Kubernetes识别容器暴露端口的唯一依据。它错一位，livenessProbe就报connection refused，Service的targetPort就找不到后端。
立即学习“go语言免费学习笔记（深入）”；
这四个值必须完全一致：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- Go代码监听的端口（比如
"0.0.0.0:8080"） -
Deployment.spec.containers[].ports[].containerPort（比如8080） -
livenessProbe.httpGet.port和readinessProbe.httpGet.port（不能写成80或空） -
Service.spec.ports[].targetPort（注意不是port字段）
常见翻车点：containerPort: 8080写了，但探针里写port: 80，或者Service里targetPort: 80——全挂。
健康探针路径必须真实存在且返回200
Kubernetes不看进程是不是running，只认HTTP状态码。没配探针，或路径404、超时、返回500，Pod就永远卡在Ready: 0/1，Ingress直接503。
实操建议：
- Go代码至少暴露两个handler：
/health（基础存活）、/ready（带DB连接检查） -
initialDelaySeconds留足启动时间：livenessProbe ≥30s（尤其有DB迁移或缓存预热）；readinessProbe可设5–10s - 别用TCP探针代替HTTP探针——TCP通只说明端口开了，不代表业务ready
- 探针路径必须和
httpGet.path完全匹配，大小写、斜杠都不能错
ConfigMap/Secret注入参数要避开硬编码陷阱
环境变量、配置文件、命令行参数都该从外部注入，而不是写死在Go代码里。但注入方式不对，照样白搭。
关键点：
- ConfigMap的
data键名要和Go里os.Getenv()或flag.String()读的key完全一致（比如ConfigMap里写APP_PORT: "8080"，代码就得读os.Getenv("APP_PORT")） - Secret注入时，确保
volumeMounts挂载路径可读，且Go代码用ioutil.ReadFile或os.ReadFile读取时路径正确（比如挂到/etc/secrets/api-key，代码就得读这个路径） - 别把敏感配置塞进
args或env.value明文字段，要用env.valueFrom.secretKeyRef或volumeMounts - ConfigMap更新后，Pod不会自动重启——除非你用Reloader或手动滚动更新
最易被忽略的是：ConfigMap挂载为volume时，文件权限默认是644，但某些Go库要求400；挂载为envFrom时，所有key变成大写+下划线，Go里os.Getenv("db_host")就读不到DB_HOST。
