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: Unavailable，但 curl http://svc:port/healthz 正常——说明 HTTP 探针通，gRPC 流量不通。
立即学习“go语言免费学习笔记（深入）”；
- 默认 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 日志源码。
