17370845950

Go云原生开发依赖工程约束而非语言框架，需无状态服务、明确健康检查、非localhost监听、合理Keepalive配置、结构化slog日志及OTel兼容，细节决定落地成败。

Go 本身不提供“云原生应用构建框架”，所谓“Golang 云原生开发”是围绕 net/http、grpc-go、gin 或 echo 等轻量 HTTP 框架，配合容器化、服务发现、配置中心、可观测性等外部能力组合实现的——关键不在语言，而在工程约束和部署契约。

用 net/http 写一个符合云原生边车（sidecar）通信规范的服务

云原生服务常需与 Istio Envoy 或其他 sidecar 共存，要求服务自身无状态、快速就绪、健康检查路径明确、不绑定端口或地址。

• http.ListenAndServe 必须传入 ":8080" 而非 "localhost:8080"，否则无法被同一 Pod 内的 sidecar 访问
• 就绪（readiness）和存活（liveness）探针应复用同一个 http.Handler，避免额外 goroutine 或锁竞争
• 启动时不要阻塞在数据库连接或远程配置拉取上；失败应直接 os.Exit(1)，由 K8s 重启代替重试逻辑

func main() {
    http.HandleFunc("/healthz", func(w http.ResponseWriter, r *http.Request) {
        w.WriteHeader(http.StatusOK)
        w.Write([]byte("ok"))
    })
    log.Fatal(http.ListenAndServe(":8080", nil))
}

为什么 go mod vendor 在云原生 CI/CD 中通常多余

标准云原生镜像构建流程（如 Dockerfile 多阶段构建）已天然隔离依赖：build 阶段用 GOPROXY 下载模块，final 阶段只拷贝二进制。vendor 目录反而增加镜像体积、干扰依赖审计、且无法解决 //go:embed 或 cgo 场景。

• CI 流水线中若使用 go build -mod=readonly，vendor 会掩盖 go.sum 不一致问题
• Kubernetes Init Container 若需预热缓存，应通过 go mod download 而非复制 vendor
• 唯一适用 vendor 的场景：离线环境 + 构建机无 GOPROXY 权限，但此时更应推动基建而非妥协代码

grpc-go 服务暴露给 Kubernetes Service 时的常见连接拒绝错误

错误现象：connection refused 或 gRPC status code: U

• 默认 gRPC Server 不启用 KeepaliveParams，K8s Service 的 conntrack 表可能因长连接空闲超时而主动断开
• 必须显式设置 keepalive.ServerParameters{MaxConnectionAge: 30 * time.Second}
• Kubernetes Service 类型为 ClusterIP 时，gRPC 客户端必须用 DNS 名（如 my-svc.default.svc.cluster.local:9000）而非 IP，否则 TLS SNI 或负载均衡失效
• 若启用了 mTLS（如 Istio），服务端 grpc.Creds 必须用 credentials.NewTLS(nil)，让 sidecar 处理证书，而非自己加载 cert

用 log/slog 输出结构化日志并兼容 OpenTelemetry Collector

云原生日志不追求人类可读，而要能被 otelcol 识别 trace_id、span_id、service.name 等字段。Go 1.21+ 的 slog 默认输出是 key-value 平铺，但需微调格式才能被主流采集器解析。

• 避免用 slog.String("msg", "xxx")，改用 slog.With("service.name", "auth-api") 提前绑定静态属性
• 输出格式必须为 JSON，且字段名遵循 OTel Logs Data Model：如 trace_id、span_id、severity_text（不是 level）
• 在 HTTP handler 中注入 trace context：用 slog.With("trace_id", trace.SpanFromContext(r.Context()).SpanContext().TraceID().String())

handler := slog.NewJSONHandler(os.Stdout, &slog.HandlerOptions{
    AddSource: true,
    Level:     slog.LevelInfo,
})
slog.SetDefault(slog.New(handler))

真正卡住云原生落地的，从来不是 Go 语法或框架选型，而是对 livenessProbe 超时值是否覆盖了 GC STW、initContainer 失败后是否会触发主容器的 readiness probe、或者 otel-collector 的 loggingexporter 是否把 severity_number 映射错成 int64 这类细节——这些地方没文档，只能翻 K8s event、抓包、看 collector 日志源码。