Go 一次性初始化怎么缓存错误：懒加载、panic 与并发验收

配置中心、证书读取或本地规则文件，常常只需要初始化一次，但第一次读取失败时到底该不该继续重试，往往比“怎么懒加载”更容易出错。Go 的 sync.OnceValue 把一次初始化封装成函数：成功返回的值会被复用，初始化函数返回的 panic 也会按同一结果再次触发。需要同时返回值和错误时，用 sync.OnceValues 更合适。

先把一次初始化的结果边界说清楚

假设服务第一次收到请求时才读取 config/region.json。如果每个请求都自己读文件，代码容易重复；如果手写一个全局变量和互斥锁，又要处理“是否已经完成”“错误是否缓存”“并发读是否安全”这几组状态。

sync.OnceValue 只解决一次调用和结果复用，不替你判断业务上的恢复策略。文件不存在时，缓存错误通常是合理的；配置文件可能在启动后生成时，就应该把重试放在更外层，而不是偷偷期待 OnceValue 自动重试。

只返回一个值时使用 sync.OnceValue

下面的示例把规则表解析成只读结构。初始化函数只执行一次，后续调用拿到同一个返回值：

package rules

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

type Table struct {
    Region string            `json:"region"`
    Limits map[string]int    `json:"limits"`
}

var loadTable = sync.OnceValue(func() *Table {
    data, err := os.ReadFile("config/region.json")
    if err != nil {
        panic(err)
    }
    var table Table
    if err := json.Unmarshal(data, &table); err != nil {
        panic(err)
    }
    return &table
})

func Current() *Table {
    return loadTable()
}

这里的关键不是把 panic 当作业务错误，而是明确这个文件属于进程启动后不可变的基础配置。若文件损坏，继续运行反而可能让后续请求得到不完整规则。

需要返回错误时，用 sync.OnceValues 保留失败原因

很多库不适合在初始化函数里触发 panic，例如按需加载的词典、可选的本地模板或测试替身。这时用 sync.OnceValues 把值和错误一起缓存，调用方可以决定是否降级：

var loadDictionary = sync.OnceValues(func() (*Dictionary, error) {
    return openDictionary("config/dictionary.json")
})

func Lookup(key string) (string, error) {
    dictionary, err := loadDictionary()
    if err != nil {
        return "", fmt.Errorf("load dictionary: %w", err)
    }
    return dictionary.Find(key)
}

第二次调用仍会得到同一个错误结果，openDictionary 不会因为并发请求增加而重复打开文件。这个特性适合“失败即停止继续使用”的资源；如果错误具有瞬时性，例如远端服务短暂不可用，就不应把远端网络请求直接包在一次性函数里。

并发验收要检查调用次数和错误复用

测试不能只断言最终值。把初始化函数中的计数器和可控错误一起记录，才能看出是否发生了重复工作：

func TestOnceValuesCacheError(t *testing.T) {
    var calls atomic.Int32
    wantErr := errors.New("dictionary unavailable")

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

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

panic 会被缓存，别把它误当成自动重试

sync.OnceValue 的初始化函数如果 panic，后续调用仍会触发对应的 panic。这样做是为了保持一次初始化的确定性：并发调用者不会有人拿到半成品，也不会因为下一次请求碰巧成功而改变进程状态。

如果业务确实需要重试，把一次尝试包在可替换的工厂函数里，并显式记录退避、最大次数和最后一次错误。不要在 OnceValue 内部修改文件后再次调用自身，这会让初始化逻辑变得难以观察。

选择表：什么时候不该使用一次性初始化

常见问题

sync.OnceValue 会在初始化失败后自动再试吗？

不会。返回错误的 OnceValues 会复用错误，发生 panic 的 OnceValue 会再次触发对应 panic。需要重试时要显式设计另一层状态。

OnceValue 返回的指针可以被修改吗？

技术上可以，但调用方会共享同一个指针。更稳妥的做法是初始化后只读，或者返回不可变快照，避免一个请求修改后影响所有请求。

如何证明初始化函数只运行了一次？

在测试函数内用原子计数器记录初始化次数，并通过多个 goroutine 同时调用；最后同时断言计数为 1、所有调用的值一致、错误可用 errors.Is 识别。

收尾检查

把 sync.OnceValue 当成“缓存一次初始化结果”的工具，而不是通用缓存或重试器。上线前至少确认资源是否真的只读、失败是否应长期保留、返回值是否会被修改，再用并发测试覆盖成功、错误和 panic 三条路径。