go服务必须监听0.0.0.0:端口而非127.0.0.1，因kubernetes中localhost仅指向pod自身，外部流量（含service、探针、其他pod）无法访问；grpc健康检查需额外暴露http端点或使用grpc-health-probe；镜像构建须禁用cgo并静态编译。
Go服务必须监听0.0.0.0:端口，不能写127.0.0.1
Protobuf 本身不决定网络绑定行为，但 gRPC（最常用的 Protobuf 通信方式）默认使用 HTTP/2，而 Kubernetes Service 流量是通过 Pod IP 转发的。如果 Go gRPC server 启动时写成 lis, err := net.Listen("tcp", "127.0.0.1:9000")，它只接受本地回环请求，外部流量进不来，kubectl get pods 看起来 Running，但 readinessProbe 一直失败，Pod 反复重启。
正确写法是绑定到所有接口：lis, err := net.Listen("tcp", ":9000") 或显式写 "0.0.0.0:9000"。这和 HTTP 服务一样，是 Kubernetes 网络模型的基本要求。
gRPC健康检查路径要单独暴露，不能只靠/
Kubernetes 的 readinessProbe 和 livenessProbe 默认走 HTTP，而 gRPC 服务原生不响应 HTTP GET。如果你没额外处理，探针会直接返回 503 或连接拒绝，Deployment 永远不会把 Pod 加入 Endpoints。
常见解法有三种：
- 用
grpc-go/health包启动健康检查服务，并在同一个端口上复用 HTTP mux（例如用grpc-gateway或自定义http.ServeMux注册/healthz） - 改用
exec探针，执行grpc_health_probe -addr=:9000 -rpc-timeout=5s（需提前把二进制放进镜像） - 在 Deployment 中配置
tcpSocket探针——只检测端口通不通，不校验业务就绪状态，适合开发环境
生产环境推荐第一种：HTTP 健康端点 + gRPC 健康服务共存，既满足 Kubernetes 要求，又保留 gRPC 原生健康语义。
Dockerfile 必须静态编译，且禁用 CGO
Protobuf + gRPC 依赖 libprotobuf 和 libgrpc 时，动态链接会导致 Alpine 或 scratch 镜像启动失败。错误现象通常是容器立即退出，kubectl logs 显示 standard_init_linux.go:228: exec user process caused: no such file or directory——本质是找不到动态库。
解决方法很明确：
- 构建阶段加
CGO_ENABLED=0 - 指定
GOOS=linux GOARCH=amd64（或对应平台） - 用
FROM scratch或最小化 Alpine，不要装任何 C 运行时 - 确保
protoc-gen-go和protoc-gen-go-grpc生成的代码不引入 cgo 依赖（新版google.golang.org/grpc/cmd/protoc-gen-go-grpc默认已满足）
验证方式：运行 ldd your-binary，输出应为 not a dynamic executable。
Service 和 NetworkPolicy 要适配 gRPC 流量特征
gRPC 是长连接、HTTP/2 复用流，对超时、连接空闲时间更敏感。Kubernetes Service 本身不干预这些，但云厂商 LoadBalancer（如 AWS NLB、GCP Internal TCP/UDP Load Balancer）可能默认启用连接空闲超时（如 4 分钟），导致客户端报 transport is closing。
应对措施：
- 在客户端配置
KeepAliveParams，主动发送 ping - 若用 Ingress 暴露 gRPC，确认它支持 HTTP/2（Nginx Ingress 需开启
use-http2: "true"，Traefik 原生支持） - 避免在
NetworkPolicy中误封 HTTP/2 的 ALPN 协商流量（通常不需要额外放行，但若策略过于严格，可能干扰 TLS 握手）
最容易被忽略的一点：gRPC 客户端默认不带 Host header，某些 Ingress 会因此 404；建议显式设置 WithAuthority("your-service.namespace.svc.cluster.local")。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
