Go语言延迟加载如何使用OnceValues-Golang-PHP中文网

sync.oncevalues用于延迟加载可能失败的资源，支持返回(t, error)，首次调用执行初始化函数并缓存结果（含error），后续直接返回缓存值；并发安全，不重试、不panic，需显式返回error而非内部panic。

go语言延迟加载如何使用oncevalues

sync.OnceValues 用来处理带 error 的初始化

当你需要延迟加载一个可能失败的资源（比如读文件、连数据库、解析配置），sync.OnceValue 不够用——它只接受 func() T，没法返回 error。Go 1.21 同时引入了 sync.OnceValues，专为这种场景设计：它支持初始化函数返回任意数量的值，包括 error。

sync.OnceValues 的签名是 func OnceValues[T any, E error](f func() (T, E)) func() (T, E)，泛型约束明确要求第二个返回值必须是 error
它返回的闭包，首次调用时执行 f，缓存其全部返回值（含 error）；后续调用直接返回缓存结果，不重试、不重新 panic
和 sync.OnceValue 一样，并发安全，多个 goroutine 同时调用也只执行一次 f

常见错误：把错误处理逻辑塞进闭包里再 panic

有人会写类似这样的代码：

loadConfig := sync.OnceValues(func() (map[string]string, error) {
    cfg, err := os.ReadFile("config.yaml")
    if err != nil {
        panic(err) // ❌ 错误：panic 会导致程序崩溃，且 done 被设为 1，后续调用永远拿不到 error
    }
    return parse(cfg), nil
})

这违反了 sync.OnceValues 的设计前提：它依赖函数正常返回 (T, error) 来区分成功与失败。一旦 f panic，整个 goroutine 崩溃，done 仍被原子设为 1，后续所有调用都卡死或 panic，无法 fallback。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本官方下载，版本号 1.26.0，适合旧项目维护、兼容性测试和指定版本开发环境搭建。

下载

正确做法是让 f 显式返回 error，而不是 panic
如果底层库（如 sql.Open）本身不 panic，就直接返回；如果它可能 panic，需在外层 recover 并转为 error
不要在 f 内部做重试——OnceValues 不重试，失败即永久失败

实际使用：读配置文件并解析

这是最典型的 sync.OnceValues 使用场景：

package main

import (
    "encoding/json"
    "fmt"
    "os"
    "sync"
)

type Config struct {
    DBHost string `json:"db_host"`
    Port   int    `json:"port"`
}

var loadConfig = sync.OnceValues(func() (Config, error) {
    data, err := os.ReadFile("config.json")
    if err != nil {
        return Config{}, fmt.Errorf("failed to read config: %w", err)
    }
    var cfg Config
    if err := json.Unmarshal(data, &cfg); err != nil {
        return Config{}, fmt.Errorf("failed to parse config: %w", err)
    }
    return cfg, nil
})

func GetConfig() (Config, error) {
    return loadConfig()
}