线上服务偶尔会崩，日志里只有一行 `fatal error: concurrent map read and map write`，没有堆栈，进程直接挂掉。这个报错来自 Go 运行时对 map 的并发访问检测，不是 recover 能兜住的。很多人在本地压测或低流量时一切正常，一旦 QPS 上来就随机崩溃，原因通常是某个全局 map 被多个 goroutine 同时读写。Go 的 map 为了性能没有内置锁，运行时只在写操作时设置标志位，读操作检查该标志，发现冲突就主动 throw，避免出现更难排查的数据损坏。这篇文章从运行时的检测机制讲起，然后给出几种实际项目里常用的修复方式，包括 sync.RWMutex、sync.Map 和分片锁，并说明各自的取舍。

## 运行时怎么发现的

Go 的 map 结构体里有一个 `flags` 字段，其中 `hashWriting` 位表示当前有 goroutine 正在写。写操作开始前置位，结束清除；读操作（以及遍历、删除等）会检查这个位，如果发现有人在写，就调用 `throw` 终止程序。

```go
// runtime/map.go 简化示意
type hmap struct {
 flags uint8
 // ...
}

const hashWriting = 4

func mapaccess1(t *maptype, h *hmap, key unsafe.Pointer) unsafe.Pointer {
 if h.flags&hashWriting != 0 {
 throw("concurrent map read and map write")
 }
 // ...
}
```

这里的关键点是它只做“检测”，不做同步。两个 goroutine 一个读一个写，可能刚好错开，也可能刚好撞上，所以表现为偶发。多个 goroutine 同时写，则触发的是 `concurrent map writes`。两种都是 fatal error，不能被 defer recover 捕获，因为 `throw` 不走 panic 机制。

## 哪些写法会踩坑

最常见的是把 map 当缓存或注册表放在包级别，然后多个请求 goroutine 直接读写。比如：

```go
var cache = map[string]string{}

func Get(key string) string {
 return cache[key]
}

func Set(key, value string) {
 cache[key] = value
}
```

HTTP handler 里同时调 Get 和 Set，压测就崩。另外一种隐蔽的情况是在 map 上做 range 遍历的同时有别的 goroutine 写入，遍历也会检查写标志。还有通过 `sync.Once` 初始化 map 后，以为只读就安全，但如果后续有原地更新，依然会冲突。

## 用 sync.RWMutex 包一层

最直接的办法是给 map 配一把读写锁。读多写少的场景下性能可以接受。

```go
type SafeMap struct {
 mu sync.RWMutex
 m map[string]string
}

func NewSafeMap() *SafeMap {
 return &SafeMap{m: make(map[string]string)}
}

func (s *SafeMap) Get(key string) (string, bool) {
 s.mu.RLock()
 defer s.mu.RUnlock()
 v, ok := s.m[key]
 return v, ok
}

func (s *SafeMap) Set(key, value string) {
 s.mu.Lock()
 defer s.mu.Unlock()
 s.m[key] = value
}
```

要注意别在持有锁的时候调用外部函数，否则容易死锁。另外如果 value 是指针或 map，返回后外部修改仍然不受锁保护，这一点在封装时要想清楚，必要时返回副本。

## sync.Map 适合什么场景

`sync.Map` 内部用了 read map 和 dirty map 两层结构，读操作大多数时候走无锁路径，适合键集合相对稳定、读远多于写的场景，比如配置缓存、连接池里的元数据。它的 API 是 `Load`、`Store`、`LoadOrStore`、`Delete`、`Range`。

```go
var m sync.Map

m.Store("user:1", &User{Name: "alice"})
if v, ok := m.Load("user:1"); ok {
 u := v.(*User)
 _ = u
}
```

但 `sync.Map` 不是万能替换。写多读少时，dirty map 会频繁提升，性能未必比 RWMutex 好，而且它的 `Range` 不保证一致性快照。如果只是简单地把原来的 map 换成 sync.Map，接口类型断言也会让代码变啰嗦。

## 分片锁降低锁竞争

当 key 数量大、并发高，单把 RWMutex 会成为瓶颈。可以按 key 的哈希把数据分到 N 个分片，每个分片一把锁。

```go
type ShardedMap struct {
 shards [16]struct {
 mu sync.RWMutex
 m map[string]string
 }
}

func (s *ShardedMap) shard(key string) int {
 h := fnv.New32a()
 h.Write([]byte(key))
 return int(h.Sum32() % 16)
}

func (s *ShardedMap) Get(key string) (string, bool) {
 idx := s.shard(key)
 s.shards[idx].mu.RLock()
 defer s.shards[idx].mu.RUnlock()
 v, ok := s.shards[idx].m[key]
 return v, ok
}
```

分片数取 2 的幂可以用位运算代替取模，这里为了直观用了取模。分片锁的代价是内存占用略增，`Range` 需要逐分片加锁，不保证全局一致性。实际项目中如果只是缓存少量热点 key，分片锁未必划算，RWMutex 就够了。

## 一个容易忽略的点

即使读操作不加锁，只要写操作加锁，读也会因为写标志位触发 fatal error。也就是说不能只保护写。要么读写都走同一把锁，要么用 sync.Map 这种自身保证并发的结构，要么让 map 在初始化后完全只读，不再有任何写入。

如果确实需要先写后读，可以在启动阶段完成所有写入，之后再启动读的 goroutine，并且写入代码不能再碰这个 map。这种“冻结”模式在某些注册表场景下比加锁更轻量，但约束靠人为遵守，代码审查时要留意。

调试这类问题时，如果日志里只有 fatal error 没有堆栈，可以尝试用 `GOTRACEBACK=crash` 或者开启 race detector 跑测试。race detector 能定位到具体哪两行代码冲突，比等线上崩溃高效得多。

 推荐查看天气：https://www.40tianqi.com/toutunhe/10tian.html
 推荐查看天气：https://www.40tianqi.com/toutunhe/15tian.html
 推荐查看天气：https://www.40tianqi.com/toutunhe/40tian.html
 推荐查看天气：https://www.40tianqi.com/dabancheng/
 推荐查看天气：https://www.40tianqi.com/dabancheng/zuotian.html
 推荐查看天气：https://www.40tianqi.com/dabancheng/7tian.html
 推荐查看天气：https://www.40tianqi.com/dabancheng/10tian.html
 推荐查看天气：https://www.40tianqi.com/dabancheng/15tian.html
 推荐查看天气：https://www.40tianqi.com/dabancheng/40tian.html
 推荐查看天气：https://www.40tianqi.com/wulumuqixian/
 推荐查看天气：https://www.40tianqi.com/wulumuqixian/zuotian.html
 推荐查看天气：https://www.40tianqi.com/wulumuqixian/7tian.html
 推荐查看天气：https://www.40tianqi.com/wulumuqixian/10tian.html
 推荐查看天气：https://www.40tianqi.com/wulumuqixian/15tian.html
 推荐查看天气：https://www.40tianqi.com/wulumuqixian/40tian.html
 推荐查看天气：https://www.40tianqi.com/kelamayi/
 推荐查看天气：https://www.40tianqi.com/kelamayi/zuotian.html
 推荐查看天气：https://www.40tianqi.com/kelamayi/7tian.html
 推荐查看天气：https://www.40tianqi.com/kelamayi/10tian.html
 推荐查看天气：https://www.40tianqi.com/kelamayi/15tian.html
 推荐查看天气：https://www.40tianqi.com/kelamayi/40tian.html
 推荐查看天气：https://www.40tianqi.com/dushanzi/
 推荐查看天气：https://www.40tianqi.com/dushanzi/zuotian.html
 推荐查看天气：https://www.40tianqi.com/dushanzi/7tian.html
 推荐查看天气：https://www.40tianqi.com/dushanzi/10tian.html
 推荐查看天气：https://www.40tianqi.com/dushanzi/15tian.html
 推荐查看天气：https://www.40tianqi.com/dushanzi/40tian.html
 推荐查看天气：https://www.40tianqi.com/baijiantan/
 推荐查看天气：https://www.40tianqi.com/baijiantan/zuotian.html
 推荐查看天气：https://www.40tianqi.com/baijiantan/7tian.html
 推荐查看天气：https://www.40tianqi.com/baijiantan/10tian.html
 推荐查看天气：https://www.40tianqi.com/baijiantan/15tian.html
 推荐查看天气：https://www.40tianqi.com/baijiantan/40tian.html
 推荐查看天气：https://www.40tianqi.com/wuerhe/
 推荐查看天气：https://www.40tianqi.com/wuerhe/zuotian.html
 推荐查看天气：https://www.40tianqi.com/wuerhe/7tian.html
 推荐查看天气：https://www.40tianqi.com/wuerhe/10tian.html
 推荐查看天气：https://www.40tianqi.com/wuerhe/15tian.html
 推荐查看天气：https://www.40tianqi.com/wuerhe/40tian.html
 推荐查看天气：https://www.40tianqi.com/tulufan/
 推荐查看天气：https://www.40tianqi.com/tulufan/zuotian.html
 推荐查看天气：https://www.40tianqi.com/tulufan/7tian.html
 推荐查看天气：https://www.40tianqi.com/tulufan/10tian.html
 推荐查看天气：https://www.40tianqi.com/tulufan/15tian.html
 推荐查看天气：https://www.40tianqi.com/tulufan/40tian.html
 推荐查看天气：https://www.40tianqi.com/shanshan/
 推荐查看天气：https://www.40tianqi.com/shanshan/zuotian.html
 推荐查看天气：https://www.40tianqi.com/shanshan/7tian.html
 推荐查看天气：https://www.40tianqi.com/shanshan/10tian.html
 推荐查看天气：https://www.40tianqi.com/shanshan/15tian.html
 推荐查看天气：https://www.40tianqi.com/shanshan/40tian.html
 推荐查看天气：https://www.40tianqi.com/tuokexun/
 推荐查看天气：https://www.40tianqi.com/tuokexun/zuotian.html
 推荐查看天气：https://www.40tianqi.com/tuokexun/7tian.html
 推荐查看天气：https://www.40tianqi.com/tuokexun/10tian.html
 推荐查看天气：https://www.40tianqi.com/tuokexun/15tian.html
 推荐查看天气：https://www.40tianqi.com/tuokexun/40tian.html
 推荐查看天气：https://www.40tianqi.com/hami/
 推荐查看天气：https://www.40tianqi.com/hami/zuotian.html
 推荐查看天气：https://www.40tianqi.com/hami/7tian.html
 推荐查看天气：https://www.40tianqi.com/hami/10tian.html
 推荐查看天气：https://www.40tianqi.com/hami/15tian.html
 推荐查看天气：https://www.40tianqi.com/hami/40tian.html
 推荐查看天气：https://www.40tianqi.com/balikun/
 推荐查看天气：https://www.40tianqi.com/balikun/zuotian.html
 推荐查看天气：https://www.40tianqi.com/balikun/7tian.html
 推荐查看天气：https://www.40tianqi.com/balikun/10tian.html
 推荐查看天气：https://www.40tianqi.com/balikun/15tian.html
 推荐查看天气：https://www.40tianqi.com/balikun/40tian.html
 推荐查看天气：https://www.40tianqi.com/yiwuxian/
 推荐查看天气：https://www.40tianqi.com/yiwuxian/zuotian.html
 推荐查看天气：https://www.40tianqi.com/yiwuxian/7tian.html
 推荐查看天气：https://www.40tianqi.com/yiwuxian/10tian.html
 推荐查看天气：https://www.40tianqi.com/yiwuxian/15tian.html
 推荐查看天气：https://www.40tianqi.com/yiwuxian/40tian.html
 推荐查看天气：https://www.40tianqi.com/changji/
 推荐查看天气：https://www.40tianqi.com/changji/zuotian.html
 推荐查看天气：https://www.40tianqi.com/changji/7tian.html
 推荐查看天气：https://www.40tianqi.com/changji/10tian.html
 推荐查看天气：https://www.40tianqi.com/changji/15tian.html
 推荐查看天气：https://www.40tianqi.com/changji/40tian.html
 推荐查看天气：https://www.40tianqi.com/fukang/
 推荐查看天气：https://www.40tianqi.com/fukang/zuotian.html
 推荐查看天气：https://www.40tianqi.com/fukang/7tian.html
 推荐查看天气：https://www.40tianqi.com/fukang/10tian.html
 推荐查看天气：https://www.40tianqi.com/fukang/15tian.html
 推荐查看天气：https://www.40tianqi.com/fukang/40tian.html
 推荐查看天气：https://www.40tianqi.com/hutubi/
 推荐查看天气：https://www.40tianqi.com/hutubi/zuotian.html
 推荐查看天气：https://www.40tianqi.com/hutubi/7tian.html
 推荐查看天气：https://www.40tianqi.com/hutubi/10tian.html
 推荐查看天气：https://www.40tianqi.com/hutubi/15tian.html
 推荐查看天气：https://www.40tianqi.com/hutubi/40tian.html
 推荐查看天气：https://www.40tianqi.com/manasi/
 推荐查看天气：https://www.40tianqi.com/manasi/zuotian.html
 推荐查看天气：https://www.40tianqi.com/manasi/7tian.html
 推荐查看天气：https://www.40tianqi.com/manasi/10tian.html
 推荐查看天气：https://www.40tianqi.com/manasi/15tian.html
 推荐查看天气：https://www.40tianqi.com/manasi/40tian.html
 推荐查看天气：https://www.40tianqi.com/qitai/
 推荐查看天气：https://www.40tianqi.com/qitai/zuotian.html
 推荐查看天气：https://www.40tianqi.com/qitai/7tian.html
 推荐查看天气：https://www.40tianqi.com/qitai/10tian.html
 推荐查看天气：https://www.40tianqi.com/qitai/15tian.html
 推荐查看天气：https://www.40tianqi.com/qitai/40tian.html
 推荐查看天气：https://www.40tianqi.com/jimusaer/
 推荐查看天气：https://www.40tianqi.com/jimusaer/zuotian.html
 推荐查看天气：https://www.40tianqi.com/jimusaer/7tian.html
 推荐查看天气：https://www.40tianqi.com/jimusaer/10tian.html
 推荐查看天气：https://www.40tianqi.com/jimusaer/15tian.html
 推荐查看天气：https://www.40tianqi.com/jimusaer/40tian.html
 推荐查看天气：https://www.40tianqi.com/mulei/
 推荐查看天气：https://www.40tianqi.com/mulei/zuotian.html
 推荐查看天气：https://www.40tianqi.com/mulei/7tian.html
 推荐查看天气：https://www.40tianqi.com/mulei/10tian.html
 推荐查看天气：https://www.40tianqi.com/mulei/15tian.html
 推荐查看天气：https://www.40tianqi.com/mulei/40tian.html
 推荐查看天气：https://www.40tianqi.com/wujiaqu/
 推荐查看天气：https://www.40tianqi.com/wujiaqu/zuotian.html
 推荐查看天气：https://www.40tianqi.com/wujiaqu/7tian.html
 推荐查看天气：https://www.40tianqi.com/wujiaqu/10tian.html
 推荐查看天气：https://www.40tianqi.com/wujiaqu/15tian.html
 推荐查看天气：https://www.40tianqi.com/wujiaqu/40tian.html
 推荐查看天气：https://www.40tianqi.com/boertala/
 推荐查看天气：https://www.40tianqi.com/boertala/zuotian.html
 推荐查看天气：https://www.40tianqi.com/boertala/7tian.html
 推荐查看天气：https://www.40tianqi.com/boertala/10tian.html
 推荐查看天气：https://www.40tianqi.com/boertala/15tian.html
 推荐查看天气：https://www.40tianqi.com/boertala/40tian.html
 推荐查看天气：https://www.40tianqi.com/bole/
 推荐查看天气：https://www.40tianqi.com/bole/zuotian.html
 推荐查看天气：https://www.40tianqi.com/bole/7tian.html
 推荐查看天气：https://www.40tianqi.com/bole/10tian.html
 推荐查看天气：https://www.40tianqi.com/bole/15tian.html
 推荐查看天气：https://www.40tianqi.com/bole/40tian.html
 推荐查看天气：https://www.40tianqi.com/jinghe/
 推荐查看天气：https://www.40tianqi.com/jinghe/zuotian.html
 推荐查看天气：https://www.40tianqi.com/jinghe/7tian.html
 推荐查看天气：https://www.40tianqi.com/jinghe/10tian.html
 推荐查看天气：https://www.40tianqi.com/jinghe/15tian.html
 推荐查看天气：https://www.40tianqi.com/jinghe/40tian.html
 推荐查看天气：https://www.40tianqi.com/wenquan/
 推荐查看天气：https://www.40tianqi.com/wenquan/zuotian.html
 推荐查看天气：https://www.40tianqi.com/wenquan/7tian.html
 推荐查看天气：https://www.40tianqi.com/wenquan/10tian.html
 推荐查看天气：https://www.40tianqi.com/wenquan/15tian.html
 推荐查看天气：https://www.40tianqi.com/wenquan/40tian.html
 推荐查看天气：https://www.40tianqi.com/bazhou/
 推荐查看天气：https://www.40tianqi.com/bazhou/zuotian.html
 推荐查看天气：https://www.40tianqi.com/bazhou/7tian.html
 推荐查看天气：https://www.40tianqi.com/bazhou/10tian.html
 推荐查看天气：https://www.40tianqi.com/bazhou/15tian.html
 推荐查看天气：https://www.40tianqi.com/bazhou/40tian.html
 推荐查看天气：https://www.40tianqi.com/kuerle/
 推荐查看天气：https://www.40tianqi.com/kuerle/zuotian.html
 推荐查看天气：https://www.40tianqi.com/kuerle/7tian.html
 推荐查看天气：https://www.40tianqi.com/kuerle/10tian.html
 推荐查看天气：https://www.40tianqi.com/kuerle/15tian.html
 推荐查看天气：https://www.40tianqi.com/kuerle/40tian.html
 推荐查看天气：https://www.40tianqi.com/luntai/
 推荐查看天气：https://www.40tianqi.com/luntai/zuotian.html
 推荐查看天气：https://www.40tianqi.com/luntai/7tian.html
 推荐查看天气：https://www.40tianqi.com/luntai/10tian.html
 推荐查看天气：https://www.40tianqi.com/luntai/15tian.html
 推荐查看天气：https://www.40tianqi.com/luntai/40tian.html
 推荐查看天气：https://www.40tianqi.com/weili/
 推荐查看天气：https://www.40tianqi.com/weili/zuotian.html
 推荐查看天气：https://www.40tianqi.com/weili/7tian.html
 推荐查看天气：https://www.40tianqi.com/weili/10tian.html
 推荐查看天气：https://www.40tianqi.com/weili/15tian.html
 推荐查看天气：https://www.40tianqi.com/weili/40tian.html
 推荐查看天气：https://www.40tianqi.com/ruoqiang/
 推荐查看天气：https://www.40tianqi.com/ruoqiang/zuotian.html
 推荐查看天气：https://www.40tianqi.com/ruoqiang/7tian.html
 推荐查看天气：https://www.40tianqi.com/ruoqiang/10tian.html
 推荐查看天气：https://www.40tianqi.com/ruoqiang/15tian.html
 推荐查看天气：https://www.40tianqi.com/ruoqiang/40tian.html
 推荐查看天气：https://www.40tianqi.com/qiemo/
 推荐查看天气：https://www.40tianqi.com/qiemo/zuotian.html
 推荐查看天气：https://www.40tianqi.com/qiemo/7tian.html
 推荐查看天气：https://www.40tianqi.com/qiemo/10tian.html
 推荐查看天气：https://www.40tianqi.com/qiemo/15tian.html
 推荐查看天气：https://www.40tianqi.com/qiemo/40tian.html
 推荐查看天气：https://www.40tianqi.com/yanshi/
 推荐查看天气：https://www.40tianqi.com/yanshi/zuotian.html
 推荐查看天气：https://www.40tianqi.com/yanshi/7tian.html
 推荐查看天气：https://www.40tianqi.com/yanshi/10tian.html
 推荐查看天气：https://www.40tianqi.com/yanshi/15tian.html
 推荐查看天气：https://www.40tianqi.com/yanshi/40tian.html
 推荐查看天气：https://www.40tianqi.com/hejing/
 推荐查看天气：https://www.40tianqi.com/hejing/zuotian.html
 推荐查看天气：https://www.40tianqi.com/hejing/7tian.html
 推荐查看天气：https://www.40tianqi.com/hejing/10tian.html
 推荐查看天气：https://www.40tianqi.com/hejing/15tian.html
 推荐查看天气：https://www.40tianqi.com/hejing/40tian.html
 推荐查看天气：https://www.40tianqi.com/heshuo/
 推荐查看天气：https://www.40tianqi.com/heshuo/zuotian.html
 推荐查看天气：https://www.40tianqi.com/heshuo/7tian.html
 推荐查看天气：https://www.40tianqi.com/heshuo/10tian.html
 推荐查看天气：https://www.40tianqi.com/heshuo/15tian.html

线上服务偶尔会崩，日志里只有一行 fatal error: concurrent map read and map write，没有堆栈，进程直接挂掉。这个报错来自 Go 运行时对 map 的并发访问检测，不是 recover 能兜住的。很多人在本地压测或低流量时一切正常，一旦 QPS 上来就随机崩溃，原因通常是某个全局 map 被多个 goroutine 同时读写。Go 的 map 为了性能没有内置锁，运行时只在写操作时设置标志位，读操作检查该标志，发现冲突就主动 throw，避免出现更难排查的数据损坏。这篇文章从运行时的检测机制讲起，然后给出几种实际项目里常用的修复方式，包括 sync.RWMutex、sync.Map 和分片锁，并说明各自的取舍。

Go 语言中 map 并发读写为什么会 panic，以及如何正确应对

线上服务偶尔会崩，日志里只有一行 fatal error: concurrent map read and map write，没有堆栈，进程直接挂掉。这个报错来自 Go 运行时对 map 的并发访问检测，不是 recover 能兜住的。很多人在本地压测或低流量时一切正常，一旦 QPS 上来就随机崩溃，原因通常是某个全局 map 被多个 goroutine 同时读写。Go 的 map 为了性能没有

编程语言

后端

Go并发读写map导致fatal error崩溃的排查与修复方案，详解sync.RWMutex、sync.Map和分片锁三种并发安全实现及性能取舍，附带运行时检测机制原理。

代码解释

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Go 语言中 map 并发读写为什么会 panic，以及如何正确应对-腾讯云开发者社区-腾讯云

Go 语言中 map 并发读写为什么会 panic，以及如何正确应对

Go 语言中 map 并发读写为什么会 panic，以及如何正确应对

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐