go服务在kubernetes中运行失败主因是环境配置错误：监听地址须为0.0.0.0:8080而非127.0.0.1；探针路径需真实存在且与代码注册一致；dockerfile应多阶段构建并禁用cgo；service selector必须严格匹配pod labels。
Go 程序在 Kubernetes 中跑不起来，90% 不是代码问题，而是环境配置没对齐——监听地址、探针路径、镜像构建方式、Service 匹配规则这四点错一个，kubectl get pods 就显示 Running 却 curl 不通。
Go 服务必须监听 0.0.0.0:8080，不能写 127.0.0.1:8080
Kubernetes 的 Pod IP 是绑定在容器网卡上的独立地址，127.0.0.1 只对本容器内进程可见。kube-proxy、Ingress 控制器、甚至同 Pod 内其他容器都连不上它。
- 错误写法：
http.ListenAndServe("127.0.0.1:8080", nil)→ Service 流量直接丢弃 - 正确写法：
http.ListenAndServe(":8080", nil)或http.ListenAndServe("0.0.0.0:8080", nil) -
containerPort字段值（YAML 里）必须和这里监听的端口一致，否则kubectl describe pod会报Failed to connect to port - 本地
go run main.go能通 ≠ 部署后能通；别依赖本地测试结果判断网络可达性
readinessProbe 和 livenessProbe 必须独立配置且路径真实存在
Kubernetes 不看进程是否 running，只认探针返回码。没配、路径 404、端口填错、状态码不是 2xx/3xx，Pod 就永远卡在 Ready: 0/1 或反复重启。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- Go 代码至少暴露两个 handler：
/healthz（基础存活）、/readyz（带 DB 检查等就绪逻辑） -
livenessProbe.httpGet.port和readinessProbe.httpGet.port必须等于containerPort，不能写成 Service 的port -
initialDelaySeconds得留够启动时间：liveness 建议 ≥30s（尤其有 DB 迁移或缓存预热），readiness 可设 5–10s - 别用 TCP 探针替代 HTTP 探针——TCP 成功只说明端口开了，不代表业务 ready
Dockerfile 必须用多阶段 + CGO_ENABLED=0 + scratch 或 alpine
直接用 golang:alpine 运行二进制，等于把编译工具链、Go runtime 全塞进生产镜像——体积大、攻击面宽、还可能因 libc 版本不兼容崩溃。
- 构建阶段用完整 Go 环境：
FROM golang:1.22-alpine AS builder - 运行阶段切到极简环境：
FROM scratch或FROM alpine:latest - 编译时加
CGO_ENABLED=0 GOOS=linux go build -a -ldflags '-extldflags "-static"' -o main . -
USER 65532:65532以非 root 用户运行，避免容器逃逸后提权 - 忘了
EXPOSE 8080不影响功能，但容易漏掉端口意识，建议写上
Service selector 必须和 Pod labels 完全一致，一个字符都不能差
Service 不认 Deployment 名、不认镜像名、不认容器名，只靠 selector 字段去 match Pod 的 metadata.labels。大小写、空格、下划线 vs 短横，错一个就 0 个 Endpoint。
- Deployment 中写
app: go-service，Service 中就不能写app: go_service - 多个 Deployment（如
user-api、order-api）想共用一个 Service？必须统一 label 值，比如都设tier: api - 检查命令：
kubectl get pods -l app=go-service和kubectl get endpoints go-service—— 如果后者没输出，就是 label 不匹配 - Ingress 后端转发失败（502/503）的第一排查项，就是这个 selector 是否生效
最常被忽略的是探针路径和监听地址的耦合关系：/healthz 路径在代码里注册了，但 readinessProbe 却指向 /health，或者用了 TCP 探针却没意识到它无法反映 DB 连通性——这类问题不会报错，只会让流量静默丢失。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
