Go 一次性值闭包为什么适合懒加载：只执行一次与并发读取边界

服务启动时不一定马上需要全部配置：有些配置只在第一次处理报表、发送邮件或访问远端服务时才用到。把初始化直接塞进 main 会拉长启动时间，而每个请求都自己加锁又容易把一次性逻辑写散。Go 1.21 加入的 sync.OnceValue 给出的答案很小：把初始化函数包成一个可并发调用的闭包，第一次调用完成后，后续调用直接读取已经保存的结果。

sync.OnceValue 适合“无错误返回值、成功后长期复用”的懒加载；如果初始化需要返回错误，优先用 sync.OnceValues，不要把错误偷偷塞进全局变量。

先做一个真正的懒加载配置读取

下面的例子故意把工作函数写得很窄。loadConfig 只负责读取默认配置，configReady 负责保存它；业务代码只调用 configReady()，不需要知道初始化是否已经发生。

package main

import (
    "fmt"
    "sync"
)

type Config struct {
    Region string
    Limit  int
}

func loadConfig() Config {
    fmt.Println("loadConfig")
    return Config{Region: "cn-hangzhou", Limit: 100}
}

var configReady = sync.OnceValue(loadConfig)

func main() {
    first := configReady()
    second := configReady()
    fmt.Println(first == second, second.Region, second.Limit)
}

运行时只会打印一次 loadConfig，随后得到 true cn-hangzhou 100。这里的“只执行一次”不是因为 main 只调用了一次，而是返回的闭包内部保存了完成状态和结果。

并发首次读取时，谁负责等待和复用

把调用放进多个 goroutine，可以看到调用方不必自行围绕 loadConfig 加锁。第一个进入的 goroutine 负责完成初始化，其他 goroutine 等待这次调用结束，之后都拿到同一份 Config 值。

var configReady = sync.OnceValue(loadConfig)

var wg sync.WaitGroup
for i := 0; i 

这里要区分两个事实：初始化函数只有一次，但读取闭包可以调用很多次；返回的是值而不是每次重新构造的对象。如果返回值本身包含指针或可变切片，调用方仍要遵守它们的并发读写规则，OnceValue 不会替你保护内部对象。

初始化有错误时，别伪装成没有错误的值

真实配置通常会读文件或环境变量，失败不能只返回一个看似正常的零值。此时改用 sync.OnceValues，让闭包一次性保存 Config 和 error：

func loadConfig() (Config, error) {
    raw, err := os.ReadFile("config.json")
    if err != nil {
        return Config{}, err
    }
    var cfg Config
    if err := json.Unmarshal(raw, &cfg); err != nil {
        return Config{}, err
    }
    return cfg, nil
}

var configReady = sync.OnceValues(loadConfig)

cfg, err := configReady()
if err != nil {
    return fmt.Errorf("load config: %w", err)
}

如果第一次调用返回错误，后续调用会拿到同一次初始化保存的结果。这个语义适合配置在进程生命周期内不变的服务；如果你需要“失败后重新读取”，就不该把重试策略藏进 OnceValues，应在外层明确设计重试、退避和失效条件。

panic 会被记住，这不是重试机制

sync.OnceValue 和 sync.OnceValues 的另一个容易忽略的边界是 panic。初始化函数如果 panic，后续调用也会以同一个值 panic。这样可以避免一次调用看到半初始化状态，但也意味着配置校验失败后不会自动恢复。

生产代码里更稳妥的做法是让 loadConfig 把可预期的文件、解析和校验错误返回出来；只有真正不可恢复的程序不变量才考虑 panic。需要热更新时，使用带版本或过期时间的缓存结构，而不是试图重置 OnceValue 闭包。

常见问题

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

sync.Once 只协调一次执行，结果需要你另存；sync.OnceValue 直接返回保存结果的函数，少写一层共享变量。

OnceValue 能不能在初始化失败后自动重试？

不能。使用 sync.OnceValues 可以保存错误，但重试需要由外层的缓存或状态机明确控制。

OnceValue 返回的 Config 可以修改吗？

如果返回值包含指针、map 或切片，修改仍可能产生数据竞争。可以返回不可变数据，或在边界处复制后再交给调用方。

旧版本 Go 如何兼容？

OnceValue 从 Go 1.21.0 加入；更早版本可以用 sync.Once 加结果变量实现同样的基本语义，但要自己处理错误和 panic 边界。

把选择落到一个判断

只要初始化结果需要在整个进程里复用，并且不值得为失败设计重新加载路径，sync.OnceValue 就是清晰的最小方案。带错误用 sync.OnceValues，需要过期或重试则上升到显式缓存。最后别复制包含同步状态的对象，也别把“一次执行”误解成“结果对象可以随便并发修改”。