Golang源码探究 —— sync.Map

本文详细解析了Golang中sync.Map的内部结构和实现原理,重点讨论了其如何通过两个映射处理并发读写,避免了普通map的并发问题。同时介绍了sync.Map在读写、删除操作中的逻辑,以及在不同场景下的性能优化。

        Golang内置的map是不支持并发读写的,它在内部有检测机制,一旦发现并发读写,就会panic。如果需要并发读写map,有三种方案。1、使用map + Mutex 2、使用 map + RWMutex 3、使用sync.Map。前两者的效率在大部分情况下都不如官方提供的sync.Map。接下来来分析一下sync.Map是如何实现并发读写的。

 

1、sync.Map的结构

sync.Map的源码在sync/map.go中, skd版本:1.18

sync.Map的结构用图表示如下:

在这里插入图片描述

源码如下:

type Map struct {
   
   
    // 互斥锁
	mu Mutex


    /*
    	read中包含了一个可以并发访问的map,无需对mu加锁就可以访问,读写数据都会经过read map
    	它最终会包含这样一个结构:
    	type readOnly struct {
            m       map[interface{}]*entry
            amended bool     
        }
    */
	read atomic.Value // readOnly

    // dirty map 新增数据,走dirty map
	dirty map[interface{
   
   }]*entry

	// 未命中次数
	misses int
}

// readOnly is an immutable struct stored atomically in the Map.read field.
type readOnly struct {
   
   
	m       map[any]*entry
	amended bool      // 如果dirty中存在没有在m中的key时为true 
}

type entry struct {
   
   
	p unsafe.Pointer // *interface{}
}

        sync.Map结构体中包含了四个字段,其中包含了两个map[interface{}]*entry ,entry中包含了一个unsafe的Pointer,这个指针指向了真正的value值。

 

2、sync.Map读写

2.1 正常读写

Map的正常读写是走的read这个map,从read map中查找k-v。

在这里插入图片描述

2.2 追加问题

        假设我们要追加一个键值对"d":“go”,首先,因为不知道map中有没有这个key,因此需要先在read map中寻找,没有找到就会先对mu加锁,然后在下面的dirty map中追加。

在这里插入图片描述

        追加的时候,要创建一个entry,指针指向真正的值。然后要将amended置为true,表示read中的map已经不完整了,dirty map中有新追加的键值对。但是为什么要这样做?正常已存在的键值的读和修改走的都是上面的read map,而追加则是走的dirty map。因为上面的read map的读和写都不会涉及到map扩容的问题,而追加可能会导致map扩容。

在这里插入图片描述

2.3 追加后读写

        在追加后,我们要读出"d"的值,首先还是要走read这条线,read中找不到,但是amended为true,表示read中的map和dirty map不一致。因此要从dirty map中查找。读完后要把misses加1,表示一次要读的键在上面的map中未命中。随着多次的未命中,msses逐渐增加,当增加到misses == len(dirty)时,就会进行dirty提升。

在这里插入图片描述

2.4 dirty提升

        当misses与dirty map的长度相等时,就无法忍受了。因为多次在read中读取却未命中,还需要再走dirty map,这时候就会进行dirty map的提升。将上面的map干掉,将dirty提升上去,dirty变成新的read map,此时下面的dirty map为nil。后面如果追加的话,会重建dirty map。然后就会进入了初始的循环。

在这里插入图片描述

在这里插入图片描述

在这里插入图片描述

 

3 sync.Map删除

  • sync.Map的删除相比于查询、修改、新增更麻烦。
  • 删除可以分为正常删除和追加后删除。
  • 提升后,被删的key还需要特殊处理。

3.1 正常删除

        在read map中根据key找到对应的entry,但是不是删除在map中对应的entry,而是将entry中的指针置为nil,这样就没有任何指针指向真正的值了,垃圾回收器就可以进行回收。

在这里插入图片描述

3.2 追加后删除

        假设"d"是我们刚追加上去的,read map和dirty map中的数据是不一致的。如果要删除"d",首先从read map中查找,没有找到,而且amended为true。对mu进行上锁,然后取dirty map中查找,找到后将entry中的指针置为nil。但是追加后删除涉及一个提升的问题,假设删除后,后面要将dirty map提升上来,那么四个键中的其中一个是指向nil的,如果要重建下面的dirty map,是否要重建这个nil的key呢?这个时候就不重建它,而是将指针指向expunged(删除了的意思)。将指针指向expunged就是为了提醒来访问的协程,这个键值对已经被删除了,如果要删除这个键值对的话,之间删除就行了,因为在下面已经没有了。

// expunged is an arbitrary pointer that marks entries which have been deleted
// from the dirty map.
var expunged = unsafe.Pointer(new(any))

在这里插入图片描述

在这里插入图片描述

 

4、源码分析

源码如下:

读取数据的逻辑:

/*
	从Map中读取数据
*/
func (m *Map) Load
<think>嗯,用户问的是Go语言中的sync.Once怎么使用。我需要先回忆一下sync.Once的基本概念和用途。记得sync.Once是用来确保某个操作只执行一次,不管有多少个goroutine调用它。这在单例模式或者初始化配置时很有用。 首先,我应该解释一下sync.Once的作用,让用户明白为什么需要这个结构。然后,可能需要举一个例子,说明如何声明和使用它。比如,用Do方法包裹初始化函数,确保只运行一次。 然后,用户可能想知道具体的用法步骤,比如声明一个sync.Once变量,然后在需要的地方调用Do方法,传入要执行的函数。需要注意的是,传入的函数不能带参数,所以如果有参数的话,可能需要用闭包或者封装一下。 接下来,应该举一个实际的代码示例,展示如何在实际中使用sync.Once。比如初始化一个数据库连接或者配置文件,确保多个goroutine同时调用时,初始化只执行一次。这时候,可能需要用一些变量来存储初始化后的结果,比如全局变量或者结构体中的字段。 另外,需要提醒用户一些注意事项,比如传入的函数如果有不同的逻辑,可能会导致多次执行,因为sync.Once是根据实例来判断的。所以每个不同的操作需要单独的sync.Once实例。另外,错误处理的问题,如果在Do中的函数执行失败,再次调用Do时不会重试,所以需要内部处理错误,或者记录错误状态。 可能还需要提到sync.Once的内部实现原理,比如使用原子操作和互斥锁来保证并发安全,这样用户能更好地理解其高效性。但不需要太深入,点到为止即可。 用户可能会有疑问,如果有多个不同的初始化函数,应该怎么处理。这时候需要说明每个初始化函数都需要自己的sync.Once实例。比如,初始化配置和初始化数据库连接应该分别使用不同的sync.Once变量。 另外,错误处理是一个重要的点,如果在Do里面的函数返回了错误,用户可能想知道怎么处理这种情况。这时候应该建议在函数内部处理错误,或者设置一个全局的错误变量,在调用Do之后检查是否有错误发生。 总结一下,回答的结构应该是先介绍用途,然后基本用法,接着代码示例,再是注意事项,最后可能加上内部原理的简要说明。这样用户能够逐步理解并正确使用sync.Once。</think>### 一、sync.Once 的作用 `sync.Once` 是 Go 语言标准库中用于 **保证某个操作仅执行一次** 的并发安全工具。典型场景包括: - 单例模式(如数据库连接池初始化) - 延迟初始化(按需加载配置) - 避免重复计算 --- ### 二、基础用法 #### 1. 声明与调用 ```go var once sync.Once // 需要保证只执行一次的函数 initFunc := func() { fmt.Println("This runs only once") } // 在多个 goroutine 中调用 once.Do(initFunc) ``` #### 2. 完整示例 ```go package main import ( "fmt" "sync" ) var ( config map[string]string once sync.Once ) func loadConfig() { fmt.Println("Loading config...") config = map[string]string{"env": "prod", "timeout": "30s"} } func GetConfig() map[string]string { once.Do(loadConfig) // 并发安全初始化 return config } func main() { // 启动多个 goroutine 测试 var wg sync.WaitGroup for i := 0; i < 5; i++ { wg.Add(1) go func() { defer wg.Done() fmt.Println(GetConfig()) // 只有第一次会触发 loadConfig() }() } wg.Wait() } ``` 输出: ``` Loading config... map[env:prod timeout:30s] map[env:prod timeout:30s] map[env:prod timeout:30s] map[env:prod timeout:30s] map[env:prod timeout:30s] ``` --- ### 三、关键注意事项 #### 1. 函数无参数 通过闭包解决参数传递问题: ```go var ( dbConn string dbOnce sync.Once ) func InitDB(host string) { dbOnce.Do(func() { // 使用闭包传递参数 dbConn = fmt.Sprintf("connect to %s", host) }) } ``` #### 2. 错误处理 若初始化可能出错,建议内部记录错误状态: ```go var ( cache map[string]int once sync.Once initErr error ) func initCache() { defer func() { if r := recover(); r != nil { initErr = fmt.Errorf("init failed: %v", r) } }() // 可能出错的操作 cache = make(map[string]int) cache["key"] = 1 / 0 // 模拟 panic } func GetCache() (map[string]int, error) { once.Do(initCache) return cache, initErr } ``` #### 3. 不同操作需独立实例 ```go var ( onceA sync.Once onceB sync.Once ) func InitA() { onceA.Do(/* ... */) } func InitB() { onceB.Do(/* ... */) } // 需使用不同的 Once 实例 ``` --- ### 四、实现原理 `sync.Once` 通过 `uint32` 原子标志位 + 互斥锁实现: 1. 原子操作检查标志位 `done` 2. 首次执行时加锁运行函数 3. 后续调用直接返回 源码关键片段: ```go type Once struct { done uint32 m Mutex } func (o *Once) Do(f func()) { if atomic.LoadUint32(&o.done) == 0 { o.doSlow(f) } } func (o *Once) doSlow(f func()) { o.m.Lock() defer o.m.Unlock() if o.done == 0 { defer atomic.StoreUint32(&o.done, 1) f() } } ``` --- ### 五、典型应用场景 1. 全局配置加载 2. 数据库连接池初始化 3. 文件系统单次检查 4. 日志处理器设置 --- ### 六、性能建议 - 高频调用场景下性能优异(原子操作消耗极小) - 避免在 `Do` 中执行耗时操作(会阻塞后续调用) - 对需要重置的场景,建议重新创建实例而非修改 `done` 标志
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值