Go 一次性初始化适合缓存什么：惰性加载、错误复用与并发边界

服务启动时经常要加载一份配置：环境变量、文件内容或远端密钥。把这段逻辑放进每个请求里会重复读盘，放进全局变量又容易在初始化顺序上打架。Go 的 sync.OnceValue 适合把“第一次需要时计算一次，之后只读结果”表达清楚，但它不是带自动重试的缓存，也不是所有初始化问题的万能锁。

先把一次性初始化当成架构边界

配置加载器通常有两个压力：调用方很多，初始化代价却只应该付一次；初始化结果一旦发布，业务代码又希望它像普通函数一样随时读取。sync.OnceValue 把这条边界压缩成一个函数值，调用方不需要知道锁、状态位和完成通知的细节。

这里的“值”可以是结构体、切片或指针。真正重要的是：返回值在初始化完成后不会被后台逻辑悄悄修改。如果配置后续需要热更新，就应该用带版本和原子替换策略的配置管理器，别把热更新需求伪装成一次性读取逻辑。

最小实现：把配置读取延迟到第一次使用

下面的示例让配置文件只在第一次调用 Config() 时读取。初始化函数返回两个结果，因此失败信息也能被调用方显式处理。

package config

import (
    "os"
    "sync"
)

type Settings struct {
    Endpoint string
    Timeout  int
}

var Config = sync.OnceValues(func() (*Settings, error) {
    raw, err := os.ReadFile("app.toml")
    if err != nil {
        return nil, err
    }
    settings, err := parseSettings(raw)
    if err != nil {
        return nil, err
    }
    return settings, nil
})

调用方只需要写 settings, err := config.Config()。在多个 goroutine 同时第一次调用时，初始化函数仍只会运行一次；其他调用会等到这次初始化完成，再拿到同一组返回值。

为什么它不是“失败后自动再试”的缓存

一次性初始化最容易被误解的地方，是把“只执行一次”理解成“成功后才缓存结果”。实际上函数的全部返回结果都属于这次初始化的产出：成功值会复用，错误也会跟着复用。

例如首个请求启动在配置文件尚未挂载的瞬间，os.ReadFile 返回错误。即使文件随后出现，继续调用 Config() 也不会自动再读一次。这个行为对不可变依赖很安全，却不适合网络抖动、租约获取或需要人工恢复的场景。

三个适合与三个不适合的场景

这类适配场景的共同点是：初始化完成后结果稳定，重复计算没有额外收益，失败后也不会在不同调用路径里悄悄改变语义。

并发验收：不要只看“程序没崩”

测试的时候可以给初始化函数加一个原子计数器，再同时启动一批 goroutine 并发调用。验收至少覆盖三项：最终计数器数值等于1；所有调用拿到完全相同的返回结果；初始化失败时，所有调用拿到同一个错误，不会出现部分成功部分失败的情况。

var calls atomic.Int32

load := sync.OnceValues(func() (string, error) {
    calls.Add(1)
    return "ready", nil
})

// 并发调用 load 后检查 calls.Load() == 1

还要检查返回对象是否被调用方修改。sync.OnceValues 只负责一次性计算，不会替你保护返回的 map、slice 或结构体字段。需要共享可变数据时，边界应放在类型设计或额外的同步机制上。

常见问题：什么时候该换成可重试方案

sync.OnceValue 和 sync.OnceValues 有什么区别？

OnceValue 适合返回一个值，OnceValues 适合同时返回值和错误等两个结果。配置加载通常更适合后者。

初始化函数 panic 会怎样？

panic 也属于这次初始化的结果语义，后续调用不会把它当成一次普通失败重新执行。初始化函数应尽量短小，并在边界处决定是否转成显式错误。

需要失败重试时用什么？

把状态、上次错误、退避时间和并发控制写成独立的可重试加载器，或使用已有的配置刷新组件。不要在 OnceValues 外层套一个无限循环。

把选择写进代码评审清单

• 初始化函数是不是只依赖进程内的稳定输入？
• 首次失败是不是需要整个进程后续都保持失败状态？
• 返回对象对外发布之后，内部值会不会被其他逻辑修改？
• 并发场景测试能不能证明初始化函数实际只执行了1次？

如果四个问题都能回答清楚，sync.OnceValue 通常能让初始化边界更直白；只要其中一个问题指向重试、热更新或生命周期管理，就该换成更明确的状态机或资源管理器。