Go / 系统课时
使用 Once 管理并发初始化
使用 Once 管理并发初始化
并发程序里,初始化共享对象最怕“看起来只执行一次,实际上仍有竞态”。这一课用 sync.Once 建立可证明的一次性初始化,并说明错误、panic、依赖循环和需要重试时该怎样处理。
学习目标
- 解释
sync.Once.Do的一次执行与可见性保证 - 用一个并发安全的初始化器同时保存结果和错误
- 判断错误缓存、panic、依赖循环与重试需求的正确处理方式
Once 真正保证了什么
sync.Once 的核心不是“用一个布尔值挡住第二次调用”,而是让所有并发调用共享同一个完成状态。第一个进入 Do 的 goroutine 执行函数;其他调用会等待,直到这次执行返回。之后再调用同一个 Once,函数都不会再次执行。
它还提供内存可见性保证:初始化函数返回后,其他 Do 调用返回时能够看到初始化阶段写入的数据。因此,不需要再额外用手写的“双重检查锁”配合普通布尔值。
用主示例保存初始化结果
下面的 Loader 同时保存配置、错误和初始化次数。20 个 goroutine 并发调用 Load,真正读取配置的函数仍只执行一次。
package main
import (
"fmt"
"sync"
"sync/atomic"
)
type Config struct {
DSN string
}
type Loader struct {
once sync.Once
cfg Config
err error
attempts atomic.Int32
}
func (l *Loader) Load() (Config, error) {
l.once.Do(func() {
// 结果和错误都在 Once 内写入,后续调用读取同一份结果。
l.attempts.Add(1)
l.cfg, l.err = readConfig()
})
return l.cfg, l.err
}
func readConfig() (Config, error) {
return Config{DSN: "postgres://db/app"}, nil
}
func main() {
var loader Loader
var wg sync.WaitGroup
wg.Add(20)
for i := 0; i < 20; i++ {
go func() {
defer wg.Done()
_, _ = loader.Load()
}()
}
wg.Wait()
cfg, err := loader.Load()
if err != nil {
fmt.Println("error:", err)
return
}
fmt.Printf("dsn=%s\n", cfg.DSN)
fmt.Printf("attempts=%d\n", loader.attempts.Load())
}预期输出
dsn=postgres://db/app
attempts=1这里的关键不是 attempts 计数本身,而是 cfg 与 err 都只在 once.Do 内完成第一次写入,并在所有调用中复用。
失败与 panic 不会自动重试
如果 readConfig 返回错误,上面的写法会把这个错误永久缓存下来;后续 Load 只返回同一个错误,不会再次执行读取操作。这适合“进程生命周期内只尝试一次”的初始化,但不适合临时网络故障、动态凭据或需要自动重试的依赖。
panic 也不会让 Once 恢复到“未执行”状态。初始化函数发生 panic 后,这次 Do 仍被视为已经结束,之后对同一个 Once 的调用不会再次运行该函数。
管好初始化依赖
一次性初始化可以依赖另一个一次性初始化,但依赖方向必须清楚。例如数据库客户端可以先获取配置,再创建连接池;反过来配置初始化不应再调用数据库客户端初始化。
尤其不要在同一个 Once 的初始化函数里递归调用自己的 Do。Do 必须等待当前初始化函数返回,而递归调用又在等待同一个完成状态,结果就是死锁。
当依赖链越来越长时,把底层依赖先构造成显式对象,再交给上层初始化,比让多个 Once 彼此调用更容易测试和排错。
什么时候不该用 Once
sync.Once 最适合“成功或失败都只决定一次”的进程级对象,例如静态配置解析、注册表构建和只读元数据初始化。需要刷新、关闭后重建、失败重试或热更新时,应改用互斥锁加显式状态,或为每一轮生命周期创建新的对象。
判断标准很简单:如果业务语义允许“第二次尝试”,它通常就不是 sync.Once 应负责的事情。