go服务在kubernetes中无需配置网络，只需监听0.0.0.0（如":8080"）而非127.0.0.1，禁用cgo构建静态二进制，确保deployment selector与pod labels完全一致，service targetport与实际监听端口严格对齐。
Go 服务在 Kubernetes 里根本不需要、也不能“配置容器网络”——网络由 CNI 插件自动完成，你的 Go 程序只需正确监听、不干扰命名空间即可。
Go 程序监听地址必须是 :8080，不能是 127.0.0.1:8080
Pod 内的 localhost 只指向自己，Kubernetes 的 Service、kube-proxy、其他 Pod 都无法访问 127.0.0.1 绑定的端口。现象是 kubectl get pods 显示 Running，但 curl 任何 Service 或 ClusterIP 都超时或连接拒绝。
- 错误写法：
http.ListenAndServe("127.0.0.1:8080", nil) - 正确写法：
http.ListenAndServe(":8080", nil)（空 host 表示监听所有接口） - 更健壮写法：
port := os.Getenv("PORT"); http.ListenAndServe(":"+port, nil)，配合 Deployment 中env设置
Go 服务启动前必须确保 netns 已就绪，否则 readiness probe 失败
Go 的 http.ListenAndServe 是阻塞调用，但 Kubernetes 的 readiness probe 在容器启动后立刻发起 HTTP 请求。此时 server 可能还没真正 bind 成功，probe 就返回失败，导致 Pod 卡在 Ready: false。
- 不要用
time.Sleep硬等，不可靠且浪费资源 - 改用
net.Listen("tcp", ":8080")先获取 listener，再传给http.Server.Serve(lis) - readiness probe 的
/readyz路径应检查真实依赖（如 DB 连接、gRPC 健康端点），不只是返回 200 -
initialDelaySeconds至少设为5，failureThreshold别小于3
Dockerfile 必须禁用 CGO，否则 Alpine/distroless 镜像运行直接崩溃
Alpine 使用 musl libc，而默认开启 CGO 的 Go 二进制会链接 glibc；镜像构建成功，但运行时报错：standard_init_linux.go:228: exec user process caused: no such file or directory，日志里看不到具体缺失哪个库。
- 构建阶段必须加
CGO_ENABLED=0 - 推荐命令：
RUN CGO_ENABLED=0 go build -a -ldflags '-s -w -buildmode=pie' -o main . - 运行镜像优先选
gcr.io/distroless/static-debian12，比 Alpine 更省心（无 shell、无包管理器、默认 nonroot） - ENTRYPOINT 写成
ENTRYPOINT ["/main"]，确保 PID 1 是你的进程，避免信号丢失
Deployment 和 Service 的端口字段必须对齐，否则流量根本进不来
Kubernetes 不校验 containerPort 和实际监听端口是否一致，但它会严格匹配 Service.spec.ports.targetPort 与 Pod 中暴露的端口。如果 targetPort 写错，Service 就像一堵透明墙——没报错，但所有请求静默丢弃。
-
containerPort是文档性字段，可写可不写；真正起作用的是targetPort - Service 中写
targetPort: 8080，Go 程序就必须监听:8080（不能是:3000） - 若想用环境变量控制端口，Service 的
targetPort必须写成字符串名（如targetPort: http），并在 container 的ports.name字段声明对应名称 - Deployment 的
selector.matchLabels和 Pod template 的labels必须完全一致——键、值、大小写、空格，一个字符都不能差
最易被忽略的其实是网络配置的“不可见性”：你从不写一行 CNI 相关代码，也不碰 /etc/cni/net.d，但只要监听错了地址、镜像链接了动态库、或者 Service 端口配错，网络就断得毫无征兆。问题不在“怎么配”，而在“哪里不该动”。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
