sync.once.do panic后不会重试，这是设计使然；它只保证函数至多执行一次，无论正常返回或panic，done均被置为1，后续调用直接返回，单例永久失效。
sync.Once.Do panic 后不会重试，这是设计使然
很多人误以为 sync.Once.Do 在初始化函数 panic 后会自动重试，实际它只保证「执行一次」，不保证「成功一次」。一旦传入的函数 panic，done 标志位仍会被置为 1，后续所有调用都直接返回，不再执行函数体——单例就此永久失效。
常见错误是把 sql.Open、os.ReadFile 或 HTTP 请求直接塞进 Do 里，网络抖动或配置缺失导致 panic，整个服务再无法获取该单例实例。
- 不能依赖
sync.Once自动兜底或恢复 - 若需重试，必须在外层封装逻辑（如指数退避 + 新建
sync.Once实例） - 更务实的做法是在闭包内用
defer/recover捕获 panic，并显式赋值错误变量
带 error 的单例初始化必须用包级变量承接结果
sync.Once.Do 的函数签名是 func()，无法返回值。所以初始化失败时，调用方拿不到 error，也收不到 nil 实例的明确提示——除非你主动把结果和错误存成包级变量。
典型写法是声明两个包级变量：instance *DBClient 和 err error，并在 Do 的闭包里统一赋值：
var (
instance *DBClient
once sync.Once
err error
)
<p>func GetDBClient() (<em>DBClient, error) {
once.Do(func() {
instance, err = newDBClient() // 返回 (</em>DBClient, error)
})
return instance, err
}</p>
-
err必须是包级变量，否则闭包内赋值对外不可见 - 如果
newDBClient()panic，err保持零值，调用方拿到nil, nil，需额外判空 - 不要在
Do里recover后忽略错误——掩盖问题比静默失败更危险
sync.Once 声明位置错，等于没用
最常见的失效原因是把 sync.Once 声明在函数内部：
func GetInstance() *Service {
var once sync.Once // ❌ 每次调用都新建一个实例
once.Do(func() { /* ... */ })
}
这完全失去「只执行一次」的意义，因为每个 goroutine 都拿到自己的 once 实例。
-
sync.Once必须是包级变量，或结构体字段（且方法接收者为指针） - 多个单例有依赖时（A 初始化需先触发 B），双方的
once都得是包级变量 - 结构体内嵌
sync.Once可行，但Init()方法必须是func(s *Service)，否则操作的是副本
别把 sync.Once 当成单例管理器，它只管“执行一次”
sync.Once 本身不持有实例、不管理生命周期、也不提供并发访问控制。它只是一个「初始化门闩」——关上就再也打不开。
真正容易被忽略的是：初始化完成后，单例对象本身的线程安全性与 sync.Once 无关。比如一个全局 map 单例，sync.Once 能保证 map 被创建一次，但后续读写仍需自己加锁或用 sync.Map。
- 数据库连接池、日志实例、配置管理器这类对象，初始化后通常还需额外同步机制
- 不要用
sync.Once替代对共享资源的并发保护 - 它解决的是「初始化竞态」，不是「访问竞态」
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
