登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  Golang >  Go问答

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,最后留下哪个对象取决于调度时机。这个结果不一定触发数据竞争,但它违背了“删除后只接受一个重新建立者”的业务意图。

sync.Map Delete LoadOrStore 与并发候选值的关系说明图
图1:sync.Map 删除与重新建立键值的静态关系图;它是原创说明图,不是运行截图或并发时序证据。

用 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。这正是它适合“删除旧值后选择一个新对象”的原因:把竞态从两个写操作的覆盖,收敛为一个明确的胜负结果。

候选构造失败与 LoadOrStore actual loaded 结果的关系说明图
图2:候选构造与 LoadOrStore 返回结果的静态边界图;它帮助理解失败候选不应污染共享 Map。

构造失败和落败候选怎么处理

候选对象通常不是一个字面量,可能要读取配置、建立连接或申请其他资源。构造应该先在共享 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 持有连接、文件或其他资源,还要在这个分支执行对应的释放逻辑。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>