云原生应用需全链路适配云环境动态性与不可靠性，涵盖代码结构、错误处理、部署行为及可观测性；须遵循不可变基础设施、声明式配置、松耦合边界与结构化可观测性四大原则。
不可变基础设施：容器启动后别想着改配置或热更新二进制
云原生里没有“登录服务器改个配置重启进程”这回事。一旦容器启动，./main 进程、环境变量、挂载的 ConfigMap 都应视为只读。任何变更必须触发新镜像构建 + 新Pod调度。
- 错误做法：
os.Setenv("DB_URL", "new-url")在运行时修改，或通过fsnotify监听文件重载配置（易竞态、难审计） - 正确做法：所有配置走环境变量或
ConfigMap/Secret挂载；启动时一次性加载，不支持运行时变更 - 陷阱：用
flag.Parse()读命令行参数，但K8s中args写死在 YAML 里，改起来比改镜像还麻烦 → 改用环境变量驱动初始化逻辑
声明式配置优先：用YAML描述“要什么”，而不是“怎么做”
你的 Go 代码不该自己去调 Kubernetes API 创建 Service 或 HPA——那是控制器干的事。你的职责是暴露 /healthz、响应 readiness probe、按约定格式输出 metrics，剩下的交给声明式系统。
- 典型信号：如果项目里有
clientset.CoreV1().Pods(...).Create(...)，且不是 Operator 场景，大概率越界了 - 健康检查端点必须真实反映服务状态：
/healthz只检查自身（如 HTTP server 是否监听），/readyz要检查下游依赖（如 DB 连通性、Redis 响应），K8s 就绪探针才不会误杀流量 - metrics 路径（如
/metrics）必须返回 Prometheus 格式文本，字段名带_total、_duration_seconds等后缀，否则采集器解析失败
松耦合与边界控制：internal/ 是防线，不是装饰
internal/ 目录不是摆设——它是防止包被外部意外导入的编译级防火墙。云原生微服务一旦边界模糊，升级一个服务就会引发连锁编译失败或隐式依赖爆炸。
- 错误结构：
myapp/storage/mysql.go被cmd/api/main.go和外部 CLI 工具同时 import → MySQL 驱动版本一升级，CLI 就炸 - 正确结构：把数据库操作封装进
internal/storage，对外只暴露接口（如type UserRepository interface { GetByID(ctx, id) (User, error) }），cmd/和pkg/都不能越过internal/直接调用具体实现 - 工具验证：CI 中加
go list -deps ./... | grep 'internal/'，确保无外部包穿透
可观测性不是“加个日志就行”：结构化+指标+上下文缺一不可
云环境里，单个请求可能横跨 5 个服务、12 个 goroutine。没有 trace ID 关联、没有 latency 分位数、只有 log.Printf("got req")，等于放弃调试权。
立即学习“go语言免费学习笔记（深入）”；
- 日志必须结构化：
zap或zerolog，禁止拼接字符串；关键字段如trace_id、user_id、http_status要随上下文透传 - 指标要有语义：
http_request_duration_seconds_bucket{le="0.1"}比api_latency_ms更利于 Prometheus 聚合 - 错误不吞不裸抛：
errors.Wrap(err, "failed to fetch user from cache")，保留原始堆栈；HTTP handler 中统一用gin.H{"error": err.Error()}返回，别直接panic
