云原生是约束下的设计选择，核心是适配容器生命周期、声明式配置、可观测性与弹性伸缩；Go 因轻量二进制、无依赖部署及标准库支持，天然契合；必须显式实现健康检查（/healthz、/readyz）、优雅退出（监听 SIGTERM + Shutdown）和配置注入（环境变量优先，禁用硬编码 config.yaml）。
云原生不是框架，而是约束条件下的设计选择
用 Go 写云原生应用，核心不在于“选哪个微服务框架”，而在于主动适配容器生命周期、声明式配置、可观测性接口和弹性伸缩模型。Go 本身没有内置的“云原生 SDK”，但它的轻量二进制、无依赖部署、明确的错误处理和标准库对 HTTP/gRPC/health check 的原生支持，天然契合云原生基础设施的要求。
常见误区是过早引入 go-kit 或 kratos 等框架——它们解决的是“如何组织业务逻辑分层”，而非“如何被 Kubernetes 正确调度”。真正关键的第一步，是让服务能被 kubelet 健康探针识别、能响应 SIGTERM、能从环境变量或 ConfigMap 加载配置。
必须实现的三个基础能力：健康检查、优雅退出、配置注入
Kubernetes 依赖这些能力做滚动更新、自动恢复和扩缩容。缺一不可，且不能靠第三方中间件“代劳”，必须在主流程中显式控制。
-
健康检查：暴露
/healthz（Liveness）和/readyz（Readiness）端点，返回200 OK即可，不要嵌入复杂逻辑；避免调用下游 DB 或缓存，否则会放大故障面 -
优雅退出：监听
os.Interrupt和syscall.SIGTERM，收到信号后关闭 HTTP server 并等待活跃连接完成（用srv.Shutdown(ctx)），超时强制退出 -
配置注入：优先使用环境变量（
os.Getenv("DB_HOST")），其次 fallback 到命令行 flag（flag.String("db-host", "localhost", "")），禁用本地config.yaml文件硬编码
func main() {
srv := &http.Server{Addr: ":8080"}
go func() {
if err := srv.ListenAndServe(); err != http.ErrServerClosed {
log.Fatal(err)
}
}()
sigChan := make(chan os.Signal, 1)
signal.Notify(sigChan, os.Interrupt, syscall.SIGTERM)
<-sigChan
ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
defer cancel()
if err := srv.Shutdown(ctx); err != nil {
log.Fatal(err)
}
}
日志、指标、链路追踪必须标准化输出
云原生平台（如 Prometheus、Jaeger、Loki）只认标准格式。Go 默认的 log 包输出无法被采集，必须改用结构化日志库，并统一字段名。
立即学习“go语言免费学习笔记（深入）”；
- 日志用
zerolog或zap，输出 JSON，字段包含level、ts、service、trace_id - 指标暴露用
prometheus/client_golang，注册到http.DefaultServeMux的/metrics路径，不要自定义路径 - 链路追踪需在 HTTP handler 中提取
traceparentheader，用opentelemetry-go注入 span context，避免手动传参污染业务逻辑
特别注意：log.Printf 或 fmt.Println 输出会被容器 runtime 当作 stdout 直接丢给日志收集器，但字段不可索引、无法过滤。生产环境必须禁用。
构建镜像时禁用 CGO，多阶段构建压缩体积
Go 编译出的二进制默认静态链接，但若启用 CGO_ENABLED=1（例如用了 net 包的 DNS 解析），会动态依赖系统库，导致 Alpine 镜像运行失败。同时，未清理的构建依赖会让镜像体积暴涨 5–10 倍。
- 构建时加
CGO_ENABLED=0，确保纯静态二进制 - 用
scratch或distroless/static作为最终 base 镜像，不带 shell、包管理器、证书库 - 编译参数加
-ldflags="-s -w"去除调试符号和 DWARF 信息
FROM golang:1.22-alpine AS builder WORKDIR /app COPY . . RUN CGO_ENABLED=0 go build -a -ldflags="-s -w" -o /app/app . FROM gcr.io/distroless/static COPY --from=builder /app/app /app EXPOSE 8080 CMD ["/app"]
最容易被忽略的是证书问题：distroless/static 没有 /etc/ssl/certs，HTTP client 访问 HTTPS 地址会报 x509: certificate signed by unknown authority。解决方案只有两个：要么换用 gcr.io/distroless/base（含 ca-certificates），要么在代码中显式加载证书文件。
