当前位置：首页 > 文章列表 > Golang > Go问答 > Go 一次性值闭包为什么适合懒加载：只执行一次与并发读取边界

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

来源：17golang原创 2026-08-27 12:24:34 0浏览收藏

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

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

要点速览

sync.OnceValue 的初始化函数只执行一次，返回闭包可以被多个 goroutine 同时调用。
第一次调用前，loadConfig 尚未运行；第一次调用后，configReady 成为所有调用方共享的结果。
初始化函数发生 panic 时，后续调用会重复同一个 panic；它不是自动重试器。
需要保留初始化错误时，使用 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 只调用了一次，而是返回的闭包内部保存了完成状态和结果。

Go sync.OnceValue 中 loadConfig 首次调用后把 configReady 变成共享结果的调用链示意图

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

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

var configReady = sync.OnceValue(loadConfig)

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

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

多个 goroutine 并发调用 Go sync.OnceValue 后等待 loadConfig 并读取同一份 configReady 结果的控制流示意图

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

真实配置通常会读文件或环境变量，失败不能只返回一个看似正常的零值。此时改用 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，应在外层明确设计重试、退避和失效条件。