让多个 goroutine 共享同一个 sync.once,并对它调用 do。同一个 once 实例会执行初始化函数一次,其他调用会等这次执行结束。初始化如果失败,需要根据业务决定是否缓存失败,或采用允许重试的机制。

使用 sync.Once 实现单次初始化
要确保一段代码只运行一次,首先需要导入 sync 包并声明一个 sync.Once 变量。通常将其定义为全局变量或嵌入到结构体中。核心逻辑是将初始化操作封装在一个匿名函数中,并通过调用 o.Do(initFunc) 来触发。无论 Do 被调用多少次,只有第一次调用会执行传入的函数,后续调用将直接返回。
package main
import (
"fmt"
"sync"
)
var (
once sync.Once
resource string
)
func initResource() {
// 模拟耗时或昂贵的初始化操作
resource = "Database Connection Established"
fmt.Println("Initializing resource...")
}
func GetResource() string {
// 无论调用多少次,initResource 只执行一次
once.Do(initResource)
return resource
}

验证并发场景下的单次执行
为了验证 sync.Once 在并发环境下的有效性,可以启动多个 goroutine 同时请求资源。如果实现正确,控制台输出的初始化日志应该只出现一次,而所有 goroutine 都能获取到相同的资源字符串。这证明了内部机制处理了竞态条件,避免了多次初始化带来的副作用。
func main() {
var wg sync.WaitGroup
// 启动 10 个 goroutine 同时获取资源
for i := 0; i <p>预期输出结果如下。注意观察,尽管启动了 10 个协程,但 "Initializing resource..." 仅打印了一次,随后每个协程都成功获取到了资源。</p><pre class="brush:php;toolbar:false;">Initializing resource...
Goroutine 3 got: Database Connection Established
Goroutine 7 got: Database Connection Established
Goroutine 1 got: Database Connection Established
Goroutine 5 got: Database Connection Established
Goroutine 9 got: Database Connection Established
Goroutine 2 got: Database Connection Established
Goroutine 8 got: Database Connection Established
Goroutine 4 got: Database Connection Established
Goroutine 6 got: Database Connection Established
Goroutine 0 got: Database Connection Established
对比错误做法:为什么不能用 bool 标记
许多初学者倾向于使用一个全局布尔变量 initialized 来标记是否已初始化。这种写法在单线程下看似正常,但在并发环境下存在严重的数据竞争问题。即使加上了简单的判断,由于读写 initialized 变量本身不是原子操作,多个 goroutine 可能同时看到 false,从而同时进入初始化逻辑,导致资源被多次初始化,甚至引发内存错误或状态不一致。
// 错误的示例:存在数据竞争
var initialized bool
var badResource string
func BadGetResource() string {
if !initialized {
// 多个 goroutine 可能同时通过此检查
badResource = "Bad Connection"
initialized = true // 非原子操作
}
return badResource
}
如果使用 go run -race 运行上述错误代码,Go 运行时检测器会明确指出数据竞争。相比之下,sync.Once 内部使用了互斥锁和双重检查锁定机制,确保了初始化的原子性和可见性,是生产环境中唯一推荐的简单单次初始化方案。










