用 sync.Once 实现线程安全的延迟初始化-Golang

sync.once.do 通过 uint32 状态字段和原子操作确保函数只执行一次,首次调用者执行,其余自旋等待;若函数 panic,once 认为已执行完毕,不重试;需在闭包内完成全部初始化,避免捕获外部变量。

sync.Once.Do 为什么能保证只执行一次

sync.Once.Do 内部用一个 uint32 状态字段 + 原子操作控制执行流程,不是靠锁阻塞所有 goroutine,而是让首次调用者真正执行函数,其余并发调用者自旋等待直到完成。这意味着即使 100 个 goroutine 同时调用 Do,也只会触发一次初始化逻辑。

注意:它不保证“立即返回”,只保证“最终只执行一次”;被包装的函数若 panic,sync.Once 会认为已执行完毕(不会重试),后续调用直接返回——这点常被忽略。

典型误用:把 newDB 或 newCache 写在 Do 参数里

常见错误是把构造逻辑直接写进 Do 的闭包中,却没意识到闭包捕获变量可能导致非预期行为:

// ❌ 错误:db 可能为 nil,且每次调用都新建 *sql.DB 实例(但只保留最后一次赋值)
var db *sql.DB
once.Do(func() {
    db = newDB() // newDB() 每次都执行,只是结果被覆盖
})

正确做法是把初始化逻辑完全封装在闭包内,并确保副作用只发生一次:

夏夕资源网专注于CMS网站模板,主流语言整站网站源码下载,网站建设相关教程分享,好用的软件素材整合下载,提供一站式便捷自助服务。
1. 本站所有资源来源于用户上传和网络,如有侵权请邮件联系站长!
2. 分享目的仅供大家学习和交流,您必须在下载后24小时内删除!
3. 不得使用于非法商业用途,不得违反国家法律。否则后果自负!
4. 本站提供的源码、模板、插件等等其他资源,都不包含技术服务请大家谅解!
5. 如有链接无法下载、失效或广告,请联系管理员处理!
6. 本站资源售价只是赞助,收取费用仅维持本站的日常运营所需!
7. 如遇到加密压缩包,默认解压密码为"zy.lucklyus.top",如遇到无法解压的请联系管理员!
夏夕资源网-网站模板_免费源码_资源素材 » 用 sync.Once 实现线程安全的延迟初始化-Golang
在线时间:12:00 - 22:00
关注微信公众号:微信公众号
站长邮箱:[email protected]
  • 运营天数: 1392+
  • 资源总数: 47989+
  • 用户总数: 1+
  • 今日更新: 0+
  • 访问次数: 4007658+
  • 本周更新: 0+
  • 最后更新: 2026-03-16

本站指数

×
  • 运营天数: 1392+
  • 资源总数: 47989+
  • 用户总数: 1+
  • 今日更新: 0+
  • 访问次数: 4007658+
  • 本周更新: 0+
  • 最后更新: 2026-03-16