Go sync.Map Delete 后用 LoadOrStore 避免并发替换竞态
来源:17golang原创
时间:2026-11-17 11:17:23 168浏览 收藏
如果一个键代表可热更新的配置、连接或缓存对象,常见流程是先用 Delete 清掉旧值,再构造新值放回 sync.Map。真正危险的地方不在删除,而在“先 Load 判断不存在,再 Store”这两次操作之间:两个 goroutine 都可能看到空位,随后互相覆盖。要让删除后的重新建立只有一个候选成为键的当前值,可以让构造完成的候选直接进入 LoadOrStore,并根据 loaded 判断自己是否胜出。
官方参考:https://pkg.go.dev/sync#Map.LoadOrStore
这套模式的核心不是让所有 goroutine 都只构造一次,而是让“谁把候选放进空键”这件事只有一个成功者。loaded=false表示当前候选被存入,loaded=true表示键已经被别的 goroutine 建立,应使用返回的actual,并清理自己没有发布的候选。
先看 Delete 后为什么会出现两个发布者
sync.Map 本身支持并发访问,但把多个方法串成业务动作,不会自动把它们合成一个不可分割的事务。下面的写法看起来直观,却给两个 goroutine 留出了同一个空窗:
package main
import "sync"
func unsafeRestore(m *sync.Map, key string, candidate any) any {
// Load 和 Store 之间没有共同的原子判定,两个调用者都可能读到不存在。
if _, ok := m.Load(key); !ok {
// 后到的调用者仍可能执行到这里,覆盖先到者刚放入的值。
m.Store(key, candidate)
}
value, _ := m.Load(key)
return value
}
例如,调用者 A 和 B 都在 Delete(key) 之后开始恢复。A 的 Load 返回不存在,B 的 Load 也可能返回不存在;A、B 随后分别 Store,最后留下哪个对象取决于调度时机。这个结果不一定触发数据竞争,但它违背了“删除后只接受一个重新建立者”的业务意图。

用 LoadOrStore 让键的重新建立只有一个胜者
LoadOrStore(key, value) 的返回值是 actual 和 loaded:键已经有值时返回已有值并令 loaded=true;键没有值时存入传入的候选,并令 loaded=false。因此,重新建立动作可以把“发布权”交给这一次调用:
package main
import "sync"
func publishCandidate(m *sync.Map, key string, candidate any) (any, bool) {
// LoadOrStore 把“已有值”和“候选值”的选择放在一次 Map 操作中完成。
actual, loaded := m.LoadOrStore(key, candidate)
if loaded {
// loaded=true 说明别人先发布,actual 才是当前键对应的对象。
return actual, false
}
// loaded=false 说明本次候选成功占据空键。
return actual, true
}
注意这里的“胜出”只表示成功建立空键,不表示构造过程只有一份。A、B 都可以先在 Map 外构造候选,进入 LoadOrStore 后只有一个候选被保存;另一个调用会拿到已保存的 actual。这正是它适合“删除旧值后选择一个新对象”的原因:把竞态从两个写操作的覆盖,收敛为一个明确的胜负结果。

构造失败和落败候选怎么处理
候选对象通常不是一个字面量,可能要读取配置、建立连接或申请其他资源。构造应该先在共享 Map 外完成;只有没有错误的候选,才进入 LoadOrStore。如果候选携带需要显式释放的资源,发现自己落败后也不能直接丢弃:
package main
import (
"fmt"
"sync"
)
type Client struct {
Name string
}
func buildClient(name string) (*Client, error) {
// 真实项目可在这里加载配置或建立连接;失败时不返回半成品。
if name == "" {
return nil, fmt.Errorf("client name is empty")
}
return &Client{Name: name}, nil
}
func restoreClient(m *sync.Map, key, name string) (*Client, error) {
candidate, err := buildClient(name)
if err != nil {
// 构造失败不触碰共享 Map,避免把错误状态发布给读者。
return nil, err
}
actual, loaded := m.LoadOrStore(key, candidate)
if loaded {
// 指针示例中落败对象没有外部资源;有连接时应在这里 Close/Release。
return actual.(*Client), nil
}
// 类型断言只针对本函数写入的 *Client;其他写入者应统一值类型。
return candidate, nil
}
如果落败候选持有文件、连接或后台 goroutine,应该把清理动作放在 loaded=true 分支,而不是把它误当作当前值继续使用。反过来,构造失败时不能把 nil 当成“暂时可用的占位对象”存进去,否则后续读取者很难区分“键不存在”“对象初始化失败”和“确实存了一个空值”。
这套模式能保证什么,不能保证什么
| 问题 | LoadOrStore 能提供的语义 | 代码需要自己决定的边界 |
|---|---|---|
| 两个候选同时恢复 | 只有一个候选能以 loaded=false 建立空键 | 另一个候选是否需要关闭、回收或记录原因 |
| 构造函数失败 | 不自动处理,也不会替你回滚外部资源 | 在进入 Map 前返回错误,不发布半成品 |
| 删除后有人先写入 | loaded=true 时保留已有 actual | 确认“保留先到者”是否符合业务规则 |
| 必须无条件替换 | 不保证新候选覆盖已经存在的值 | 改用更适合无条件替换的同步设计,而不是误用本模式 |
最后可以把判断压缩成一句话:删除之后,如果需求是“空键只允许一个候选发布,已有值就沿用”,用 LoadOrStore 并检查 loaded;如果需求是“无论谁先写都必须由我覆盖”,那就是另一种更新语义,不能把 LoadOrStore 当作万能替换器。
常见问题
Delete 之后还需要先 Load 判断吗?
通常不需要。对“空键发布”这个动作,直接调用 LoadOrStore 就能同时得到已有值和候选是否成功;额外的 Load 只会重新引入判断与发布之间的窗口。
loaded=true 时能继续使用自己构造的 candidate 吗?
不能把它当作 Map 当前值。应使用返回的 actual;如果 candidate 持有连接、文件或其他资源,还要在这个分支执行对应的释放逻辑。
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习