Go / 系统课时

使用 Once 管理并发初始化

使用 Once 管理并发初始化

并发程序里,初始化共享对象最怕“看起来只执行一次,实际上仍有竞态”。这一课用 sync.Once 建立可证明的一次性初始化,并说明错误、panic、依赖循环和需要重试时该怎样处理。

学习目标

  • 解释 sync.Once.Do 的一次执行与可见性保证
  • 用一个并发安全的初始化器同时保存结果和错误
  • 判断错误缓存、panic、依赖循环与重试需求的正确处理方式

Once 真正保证了什么

sync.Once 的核心不是“用一个布尔值挡住第二次调用”,而是让所有并发调用共享同一个完成状态。第一个进入 Do 的 goroutine 执行函数;其他调用会等待,直到这次执行返回。之后再调用同一个 Once,函数都不会再次执行。

它还提供内存可见性保证:初始化函数返回后,其他 Do 调用返回时能够看到初始化阶段写入的数据。因此,不需要再额外用手写的“双重检查锁”配合普通布尔值。

用主示例保存初始化结果

下面的 Loader 同时保存配置、错误和初始化次数。20 个 goroutine 并发调用 Load,真正读取配置的函数仍只执行一次。

go
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())
}

预期输出

text
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 应负责的事情。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 Once 管理并发初始化

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通