sync.Once用于确保并发环境下初始化操作只执行一次,适用于单例、配置加载、连接池等懒加载场景;其通过原子标志位和互斥锁实现线程安全、高效且幂等的首次执行保障。

延迟加载为什么需要Mutex
Go里延迟加载(lazy initialization)常见于单例、配置解析、连接池等场景,核心是“第一次用时才创建,之后复用”。但多协程并发首次调用时,sync.Once虽更轻量,若需在初始化过程中做状态判断、条件分支或复用已有资源(比如检查某个字段是否已设置),就得手动控制——这时直接裸写 if instance == nil 会触发竞态,必须加锁。
用Mutex实现延迟加载的正确写法
关键不是“加锁就行”,而是避免双重检查失效和锁粒度不合理。典型错误是只在创建前加锁,忽略创建后赋值的可见性问题(虽然Go内存模型对写操作有较强保证,但逻辑上仍需完整临界区)。
正确做法:
- 声明一个
sync.Mutex和一个指针变量(如instance *Service) - 每次访问都先读取变量,非空则直接返回(无锁快路径)
- 为空时获取锁,再次检查(防止多个协程同时进入临界区后重复初始化)
- 初始化完成后,再赋值并解锁
示例:
var (
mu sync.Mutex
instance *DBClient
)
func GetDBClient() *DBClient {
if instance != nil {
return instance
}
mu.Lock()
defer mu.Unlock()
if instance == nil {
instance = NewDBClient() // 初始化耗时操作
}
return instance
}
为什么不能省略第二次检查
如果去掉锁内的 if instance == nil,多个协程在第一次检查后同时阻塞在 mu.Lock(),等前一个释放锁后,后续协程仍会执行初始化,造成资源浪费甚至 panic(比如重复 Close 已关闭的连接)。
常见错误现象:
-
panic: close of closed channel(重复关闭通道) - 数据库连接数超出限制(
NewDBClient创建了多个连接) - 日志中出现多次“initialized DB client”打印
对比 sync.Once 的适用边界
sync.Once 更适合“纯初始化、无条件分支、不关心中间状态”的场景。一旦 Do 执行完成,就不可重置。而 Mutex 方案可配合条件逻辑,例如:
- 根据环境变量决定是否启用缓存层
- 初始化失败后尝试降级方案(如 fallback 到内存 map)
- 需要在初始化前后更新其他共享状态(如计数器、健康标记)
但代价是:每次调用都有一次原子读(快路径)+ 可能的锁竞争(慢路径),性能略低于 sync.Once。高并发下若初始化极快,Mutex 反而成为瓶颈。
真正难处理的是初始化函数本身含阻塞或依赖外部服务——此时要加超时、重试、错误透出,而这些逻辑放在 sync.Once 里会污染单一职责,Mutex 就成了更可控的选择。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











