预热必须在 main() 中同步执行，不能放 init() 或 goroutine；需按 InitDB→InitRedis→preloadCache→http.ListenAndServe 顺序初始化运行时依赖，并通过 /readyz 真实验证各客户端状态，失败时设降级标记并告警。
预热必须在 main() 里同步执行，不能放 init() 或 goroutine
Go 模块依赖缓存（如 go mod download 缓存、$GOCACHE）本身是构建期产物，K8s Pod 启动时并不“重新下载模块”，但你真正想预热的，其实是运行时依赖：DB 连接池、Redis 客户端、gRPC 连接、本地缓存结构体初始化等。这些不是 Go 语言层的“模块缓存”，而是应用层的运行态资源。
常见错误是把 preloadCache() 放进 init() 函数——此时 *sql.DB 和 redis.Client 都还是 nil，一调用就 panic；或者用 go warmUp() 异步启动，主 goroutine 在 http.ListenAndServe() 返回后退出，预热 goroutine 被强制终止，连接未建好、缓存只写了一半。
- 正确顺序只能是：
InitDB()→InitRedis()→preloadCache()→http.ListenAndServe() - 所有客户端（
redis.Client、*sql.DB、grpc.ClientConn）必须已成功初始化且可安全调用 - 若用了 Wire 等 DI 框架，确保预热函数是显式调用，不是自动注入后隐式触发
/readyz 接口要验证真实依赖状态，不是只返回 200
K8s 的 readinessProbe 默认只 GET /health，但 HTTP 服务能响应 ≠ Redis 连上了、sync.Map 填好了、gRPC 连接池 ready 了。冷启动 ≠ 启动完成，这个 gap 必须靠你自己对齐。
实操上，/readyz handler 里不能只查原子变量，得组合验证：
立即学习“go语言免费学习笔记（深入）”；
- 检查本地标记（如
dbReady.Load()、redisReady.Load()） - 加一层“最近健康检查时间戳”：比如
lastRedisPingTime.After(time.Now().Add(-5 * time.Second))，避免刚连上就断开还误判为 OK - 不建议在 handler 中同步
client.Ping()—— 超时会卡住 probe；应由预热 goroutine 定期探测并更新状态 - gRPC 客户端预热必须走真实 RPC：
HealthClient.Check(ctx, &healthpb.HealthCheckRequest{})，不能只靠grpc.Dial成功
预热失败别卡住进程，但要设降级标记并告警
预热可能失败（Redis 临时不可用、DB 连接超时），这时不能让整个 Pod 卡在启动流程里，也不能静默跳过——否则流量进来直接穿透下游。
必须用 context.WithTimeout 包裹整个预热流程，超时后立即处理：
- 记录 warn 日志，包含失败原因（如
"redis ping failed: dial tcp: i/o timeout"） - 设置降级标记：
atomic.StoreBool(&cacheWarmedUp, false) - 后续请求根据该标记决定是否走 DB 回源，或返回兜底数据
- 关键失败（如 DB 初始化失败）应主动
os.Exit(1)，让 K8s 重启 Pod，而不是带病运行
K8s 探针配置要匹配真实冷启动耗时
readinessProbe 的 initialDelaySeconds 和 timeoutSeconds 设太小，不是应用没起来，是探针把应用“杀”了。Go 应用加载 embed 文件、初始化 Prometheus 指标、建 gRPC 连接常需 5–10 秒。
实操参数建议：
-
initialDelaySeconds至少设为本地实测冷启动时间 + 3 秒缓冲（比如测出 7s，这里填 10） -
timeoutSeconds不低于 3，推荐设为 5 —— GC 停顿或 mmap 大文件时可能卡住 -
periodSeconds别设成 2，高频探测+低超时极易误判，10 是更安全起点 - 绝对不要复用同一端点做
livenessProbe和readinessProbe：/healthz只查进程存活，/readyz查依赖就绪
最易被忽略的是：预热逻辑里没做锁控制，多个 Pod 同时拉库写 Redis，不仅浪费资源，还可能因写入顺序不一致导致缓存脏读；sync.Once 只防单机重复，跨 Pod 去重得靠 SETNX cache_warmup_lock 这类外部协调机制。
