Go map 并发读写触发 fatal error:栈里两行怎么对上业务代码

压测打到 200 QPS 时进程直接退出,stderr 只有一行 fatal error: concurrent map writes,后面跟一屏 goroutine 栈。Go 的 map 不是并发安全的,运行时一旦检测到就直接 abort,recover 也接不住,服务等于瞬间全挂。

翻代码发现写操作用了 mutex,读的地方没加锁,因为当时觉得只读不会出事。实际 concurrent map read and map write 是另一条检测,读写同时发生一样会崩,报错文案不同但结果一样。

第一次修只给写操作加了锁,跑了 20 分钟又崩,栈里读的 goroutine 停在 mapaccess 上。改成 SYNc.RWMutex,读走 RLock,写走 Lock,压测 10 分钟没再出现,但 QPS 上限被锁竞争压到了 130。

读多写少的统计场景换 sync.Map 更合适,但它不适合高频写,Store 多了性能反而比加锁差。这里每秒写 3 万次,最后还是回到 RWMutex 加分片,按 key 哈希拆成 16 个 map,锁冲突降下来后 QPS 回到 210。

栈信息里 goroutine 的创建位置比崩溃位置更有用,顺着 go func 那一行才能找到是哪次请求漏了锁。分片之后遍历顺序没了,需要全量扫描的地方得先收集 key 再排序,别指望 map 的迭代顺序稳定。

确认口径:go test -race ./... 全绿,这一步不做等于没修;再跑 30 分钟 200 QPS,panic 计数 0,P99 从 480 毫秒降到 120 毫秒。

shard := &shards[fnv32(key)%16]
shard.mu.RLock()
v := shard.m[key]
shard.mu.RUnlock()

您可以还会对下面的文章感兴趣: