Go语言singleton如何并发_Go语言线程安全单例【模式】-Golang-PHP中文网

go中实现线程安全单例唯一推荐方式是sync.once，因其通过原子操作+互斥锁确保初始化函数只执行一次、解决内存可见性问题且调用者阻塞等待；而if判空非原子，多goroutine可能同时通过导致重复初始化，加锁易出错且性能差。

go语言singleton如何并发_go语言线程安全单例【模式】

Go 里实现线程安全单例，唯一推荐方式是 sync.Once；其他写法要么不安全，要么冗余，要么难维护。

为什么不能只用 if instance == nil 判断

因为 if 本身不是原子操作。多个 goroutine 同时执行时，可能都看到 instance == nil，然后各自创建新实例——结果出现多个“单例”。日志里会看到初始化逻辑被执行多次，或者 fmt.Printf("%p", GetInstance()) 打印出不同地址。

常见错误现象：Singleton instance created multiple times、对象状态不一致、资源重复申请（比如连了两次数据库）。

即使后续加 sync.Mutex，也容易漏掉第二次判空（即没做双重检查），或忘记 defer mu.Unlock() 导致死锁
手动同步无法保证内存可见性：一个 goroutine 写完 instance，另一个可能读到未完全构造的对象（Go 编译器和 CPU 可能重排指令）
每次调用都要抢锁，性能比 sync.Once 差不少

sync.Once 是怎么工作的

sync.Once 底层用原子操作 + 轻量互斥锁，确保 Do 里的函数**只执行一次**，且所有并发调用者会**阻塞等待初始化完成**，而不是各自返回 nil 或旧值。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本官方下载，版本号 1.26.0，适合旧项目维护、兼容性测试和指定版本开发环境搭建。

下载

它天然解决三个关键问题：执行一次、内存可见、调用者同步等待。

once.Do(func()) 中的函数必须无参数、无返回值；所以依赖项（如配置、连接字符串）得提前准备好
一旦 Do 执行过（哪怕内部 panic），后续调用直接跳过，不再尝试重试
instance 必须声明在 Do 外部作用域，否则闭包里赋值对外不可见
不要写 once.Do(&initFunc) —— Go 不支持函数指针传参，编译报错：cannot use &initFunc (type *func()) as type func()

带错误返回的单例怎么写

sync.Once.Do 不接受返回值，所以初始化失败不能靠函数返回 error。正确做法是把 error 和实例一起存为包级变量，并在 GetXXX() 函数里统一检查。

声明 var instance *DB, err error，注意 err 是指针类型或全局变量，避免值拷贝失效
once.Do 闭包里执行 instance, err = openDB(...)，出错就赋值给 err
调用方拿到 nil 实例时，必须主动检查 err != nil，不能默认“没 panic 就成功”
不需要额外加锁保护 err 变量：sync.Once 已保证执行顺序，*error 赋值是原子的

var (
    db   *DB
    err  error
    once sync.Once
)

func GetDB() (*DB, error) {
    once.Do(func() {
        db, err = openDB("mysql://...")
    })
    return db, err
}