sync.Once底层不用纯atomic实现,是因为atomic仅能标记状态,无法阻塞等待;需mutex配合实现goroutine排队与唤醒,确保所有调用者都等到初始化完成。

sync.Once 底层为什么不用纯 atomic 实现
因为 sync.Once 要保证「只执行一次」且「所有 goroutine 等待执行完成后再继续」,单纯用 atomic.CompareAndSwapUint32 只能解决状态标记问题,无法阻塞等待。一旦初始化函数耗时较长,后续 goroutine 必须被挂起并等它结束,而不是反复重试或失败返回——这需要同步原语协调,atomic 本身不提供等待能力。
常见错误是以为只要用 atomic.LoadUint32 + atomic.CompareAndSwapUint32 就够了,结果出现多个 goroutine 同时进入初始化逻辑,或者部分 goroutine 拿到未初始化完成的中间状态。
- 纯 atomic 方案只能做到「抢占式标记」,不能做「等待式同步」
- Go 标准库选择在 fast-path 用 atomic 判断是否已完成,在 slow-path 借助
sync.Mutex实现排队和唤醒 - 这种混合设计让 99% 的已初始化场景完全无锁,只有首次调用才进 mutex 临界区
Once.do 方法里 mutex 和 atomic 是怎么协作的
sync.Once 的 Do(f func()) 方法内部先用 atomic.LoadUint32(&o.done) 快速判断;若为 1,直接返回;若为 0,再用 atomic.CompareAndSwapUint32(&o.done, 0, 1) 尝试抢到执行权;抢成功就去执行 f(),抢失败说明别人已抢先设为 1,但此时还不能直接返回——因为那个「别人」可能还在执行中,f() 还没结束。
所以 Go runtime 在抢失败后,会 fallback 到 o.m.Lock(),然后立即 o.m.Unlock(),看似多余,实则是利用 mutex 的 waitqueue 机制:所有抢失败的 goroutine 都会被挂到这个 mutex 的等待队列里,等第一个执行完 f() 后,显式调用 o.m.Unlock()(注意不是 defer),从而唤醒全部等待者。
- 第一次成功 CAS 后,执行
f(),结束后手动 unlock mutex(此时队列里可能已有等待者) - 后续 goroutine CAS 失败 → lock → unlock → 自动被唤醒 → 再次 atomic.LoadUint32(&o.done) → 确认完成
- mutex 在这里不保护数据,只充当「条件变量」的替代品,利用其唤醒语义
自己实现简易 Once 时最容易踩的坑
很多人照着源码写简化版,却漏掉关键细节,导致竞态或死锁。最典型的是在 CAS 失败后直接 return,或者在 mutex 保护块里重复执行 f()。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
错误示例:
if atomic.LoadUint32(&o.done) == 1 {
return
}
if atomic.CompareAndSwapUint32(&o.done, 0, 1) {
f()
atomic.StoreUint32(&o.done, 1)
}
—— 这段代码没有等待逻辑,CAS 失败的 goroutine 会直接返回,根本不知道 f() 是否执行完毕。
- 必须确保所有 goroutine 最终都看到
done == 1且f()已返回,不能靠「我抢到了就执行,没抢到就不管」 - 不能在 mutex 临界区内再次调用
f(),否则多个 goroutine 可能并发执行它 - unlock 时机很重要:必须在
f()执行完之后、且仅由首个 goroutine 调用,否则唤醒过早或过晚
性能差异:为什么不用 sync.Cond 或 channel 替代 mutex
用 sync.Cond 或 chan struct{} 也能实现等待,但它们开销更大:sync.Cond 需要额外的 locker 绑定和 signal/broadcast 调度;channel 涉及内存分配、goroutine 切换和 runtime 调度器介入。而 mutex 的 waitqueue 是 runtime 内置的轻量级队列,唤醒路径极短。
实测在高并发争用下,标准 sync.Once 的 slow-path(即首次调用)比基于 channel 的手写版本快 2–3 倍,且 GC 压力更低。这不是微优化——在 init-heavy 服务(如配置加载、连接池建立)中,这点延迟会放大。
-
sync.Once的 mutex 不用于互斥访问共享数据,只作唤醒原语,因此不会因锁粒度引发扩展性问题 - runtime 对这种「单次广播唤醒」模式做了特殊优化,比如避免虚假唤醒、批量唤醒等
- 如果你真要用 channel 模拟,至少得用带缓冲的
chan struct{}+ close(),但依然无法规避调度器路径
实际用的时候,别碰 sync.Once 的字段,也别试图复用它的 done 标志去干别的事——它和 mutex 是强绑定的一体行为,拆开就失效。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










