Golang应用云原生能力取决于是否遵循运行契约：可观察、可伸缩、可自愈、不可变交付，具体体现为正确实现liveness/readiness探针、使用scratch/distroless镜像、环境变量注入配置、结构化JSON日志及平台无感接管能力。
Golang应用是否真正具备云原生能力，不能只看它跑在Kubernetes里——关键要看它是否遵循云原生的运行契约：可观察、可伸缩、可自愈、不可变交付。成熟度高低，直接反映在探针行为、依赖管理、配置方式和可观测性集成上。
健康检查接口是否区分 /healthz/liveness 和 /healthz/readiness
很多Golang服务只实现一个 /health，被Kubernetes统一用作liveness和readiness探针，结果是数据库短暂抖动就触发重启，或流量切到尚未初始化完成的服务实例上。
- liveness 应只检测进程存活（如 goroutine 是否卡死、内存是否OOM），不查外部依赖；返回失败即重启容器
- readiness 必须检查关键依赖（如
isDatabaseReady()、isCacheConnected()），失败时停止转发流量但不重启 - 避免在 readiness 中做耗时操作（如全量缓存预热），否则导致滚动更新卡住；建议加超时（
context.WithTimeout） - Kubernetes默认探针超时为1秒，若你的DB连接检查平均耗时800ms，需同步调大
timeoutSeconds: 2
容器镜像是否基于 scratch 或 distroless 构建，且无运行时依赖泄漏
用 golang:alpine 构建再 COPY 到 alpine 镜像，看似轻量，实则可能带入 libc 兼容问题或未声明的动态链接库，导致在 distroless 环境下 panic：“no such file or directory”。
- 优先使用静态编译 +
scratch基础镜像：FROM golang:1.23-alpine AS builder WORKDIR /app COPY . . RUN CGO_ENABLED=0 GOOS=linux go build -a -ldflags '-extldflags "-static"' -o server . FROM scratch COPY --from=builder /app/server / CMD ["/server"]
- 验证镜像纯净性：
docker run --rm -it应报错“not a dynamic executable”ldd /server - 若必须用 cgo（如调用 C 库），改用
gcr.io/distroless/static-debian12，而非 alpine —— 后者 musl libc 与多数 C 二进制不兼容
是否通过环境变量/ConfigMap注入配置，而非读取本地 config.yaml
硬编码配置路径或从当前目录加载 config.yaml 的Golang服务，在K8s中极易因挂载顺序、权限或路径映射错误启动失败，且无法实现“一次构建、多环境部署”。
立即学习“go语言免费学习笔记（深入）”；
- 删除所有
ioutil.ReadFile("config.yaml")类逻辑，改用标准库os.Getenv()或第三方库如spf13/pflag+koanf统一读取环境变量 - 敏感配置（如数据库密码）必须走
Secret挂载为文件或环境变量，禁止写死在代码或镜像中 - 配置变更不应要求重启：对
ConfigMap挂载的文件，可用fsnotify监听变更并热重载（注意并发安全）；对环境变量，需接受“重启生效”的云原生约定
日志输出是否结构化、无时间戳冗余、且不混用 stdout/stderr
用 log.Printf("[INFO] %s", msg) 打印日志，会导致 Loki/Promtail 无法正确解析 level 字段；把错误日志打到 stdout 而非 stderr，则会被监控系统忽略 error rate 指标。
- 强制所有日志走 JSON 格式，字段含
level、msg、ts（RFC3339）、service，例如：{"level":"info","msg":"request completed","ts":"2026-01-12T12:45:33Z","service":"user-api","status":200,"duration_ms":12.4} - 使用
zerolog或logrus（配JSONFormatter），禁用任何自定义时间格式或前缀 - error 级别日志必须写入
stderr：log.New(os.Stderr, "", 0).Println(...)；info/warn 写stdout - 禁止在日志中打印堆栈全量（
debug.PrintStack()），应提取关键 error 并用fmt.Errorf("xxx: %w", err)包装，由上层统一处理
最常被忽略的一点：Golang应用的云原生成熟度，不取决于你用了多少CNCF项目，而取决于它是否能被平台“无感接管”——K8s能自动扩缩、Prometheus能自动发现指标、Fluentd能自动切分日志、Argo CD能自动比对期望状态。一旦某个环节需要人工介入（比如改配置就得改代码再发版，或查问题必须 kubectl exec 进容器），那就还没真正云原生。
