sync.Once 是 Go 中替代 init() 实现延迟加载的首选方式,因其按需触发、并发安全、支持运行时参数,而 init() 无法延迟、不可控、难测试。

sync.Once 是 Go 中替代 init() 实现延迟加载的首选方式,它不依赖包加载时机,能按需触发、并发安全、支持运行时参数,而 init() 无法延迟、不可控、难测试。
为什么不能直接用 init() 做延迟加载
init() 函数在包被导入时立即执行,属于“预加载”行为。一旦 import 某个包,无论你后续是否用到其中的变量或函数,init() 都已跑完。这导致:
- 配置未就绪时提前 panic(比如环境变量还没 set)
- 昂贵资源(如数据库连接、大文件读取)无条件初始化,浪费内存和启动时间
- 无法注入运行时参数(
init()不接受任何参数) - 单元测试中难以控制执行顺序——
init()总是早于TestMain运行
用 sync.Once 替代 init() 的标准写法
核心是把初始化逻辑从包级自动执行,移到一个显式调用的函数中,并用 sync.Once 保证只执行一次:
var (
instance *DBClient
once sync.Once
)
func GetDBClient() *DBClient {
once.Do(func() {
// 这里可以读 env、传参、做 error 处理
instance = &DBClient{
URL: os.Getenv("DB_URL"),
}
// 可选:检查初始化结果,失败则 panic 或记录
if instance.URL == "" {
panic("DB_URL not set")
}
})
return instance
}
注意点:
- 变量声明必须是包级(否则每次调用都新建
once) -
once.Do内部不要做阻塞操作(如长耗时 HTTP 请求),否则首次调用会被卡住 - 如果初始化可能失败,建议把 error 存为字段或返回给调用方,而不是只在
Do里 panic
需要传参或多次初始化时怎么办
init() 完全不支持参数,但延迟加载场景常需动态输入(如不同命名空间的配置、用户 ID 对应的缓存实例)。这时不能死守单例模式,而是封装成工厂函数:
type Cache struct{ ns string }
func NewCache(ns string) *Cache {
return &Cache{ns: ns}
}
func (c *Cache) Get(key string) ([]byte, error) {
// 第一次访问才真正加载该命名空间的配置
if c.client == nil {
c.initOnce.Do(func() {
c.client = agollo.NewClient(agollo.WithNamespace(c.ns))
})
}
return c.client.Get(key)
}
关键区别:
- 每个
Cache实例有自己的sync.Once字段,互不影响 - 初始化时机由业务逻辑决定(第一次
Get),不是包加载时 - 避免了全局状态污染,也方便 mock 和测试
容易踩的坑:nil 检查 + 锁 ≠ sync.Once
有人试图手动实现延迟加载:
if p.real == nil {
p.real = NewExpensiveThing()
}
这是错的。并发下会触发多次初始化,甚至 panic。正确做法只有两个:
- 用
sync.Once(推荐,简洁安全) - 用
sync.RWMutex+ 双检锁(易出错,除非有特殊性能要求)
另外,别在 init() 里调用 sync.Once.Do——那只是把问题藏得更深,没解决“预加载”本质。
延迟加载真正的复杂点不在语法,而在判断“什么时候才算真正需要”。比如一个 HTTP handler 里调用了 GetDBClient(),但如果这个 handler 很少被访问,你就省下了初始化开销;可如果它每秒被调一万次,那第一次的延迟就变成了性能瓶颈。这时候得结合指标监控和预热机制,而不是只盯着 sync.Once 写没写对。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











