Go 协程安全缓存应优先组合 sync.Map(读多写少)、RWMutex+map(需 TTL/ 驱逐)或成熟库(如 freecache、ristretto);注意 TTL 时序、锁粒度、空值处理及 value 生命周期管理。

用 Go 实现协程安全的缓存系统,核心不是“自己造轮子”,而是合理组合 sync.Map、sync.RWMutex 或成熟库(如 groupcache、freecache),再配合 TTL 和原子操作,就能兼顾性能与线程安全。
用 sync.Map 做简单键值缓存(适合读多写少)
sync.Map 是 Go 标准库 提供的并发安全 map,底层做了读写分离优化,免锁读性能高。但它不支持自动过期,需手动管理生命周期。
- 只存基础类型或指针(避免复制开销),例如
sync.Map[string]*cacheItem - 写入时用
Store(key, value),读取用Load(key),不存在则返回 nil - 若需 TTL,value 可封装为结构体:red”>含数据 + 过期时间戳,读取时检查是否过期,过期则
Delete并返回未命中 - 注意:它不保证遍历一致性,不要在循环中依赖
Range的实时性
用 RWMutex + 普通 map 实现带 TTL 的可控缓存
当需要精确控制过期逻辑、支持清理 goroutine 或复杂驱逐策略(如 LRU)时,推荐自定义结构体 + sync.RWMutex。
- 读多场景下,
RWMutex.RLock()允许多个 goroutine 并发读,比纯 mutex 更高效 - 写操作(Set/Remove)用
Lock(),确保互斥;TTL 检查可在 Get 时做(惰性删除),也可另起 goroutine 定期扫描清理(主动删除) - 示例字段:
data map[string]cacheValue、mu sync.RWMutex、defaultTTL time.Duration - Get 时先 RLock → 查找 → 检查过期 → 未过期则返回,否则 RUnlock 后 Lock 删除并返回空
避免常见并发陷阱
协程安全不是加把锁就万事大吉,几个关键细节容易被忽略:
立即学习“go 语言免费学习笔记(深入)”;
- map 本身不能直接并发读写 —— 即使包了 mutex,也要确保所有访问都走同一把锁,别漏掉某个分支
- value 若是结构体且含指针或 map/slice,要警惕浅拷贝导致多个 goroutine 修改同一底层数组
- 缓存穿透:对空结果也缓存(如 value 设为 nil + 单独标记),避免反复查 DB;可用布隆过滤器前置拦截
- 缓存雪崩:不同 key 的过期时间别集中,加随机偏移(如
ttl + rand.Int63n(1e9))
生产环境建议直接用成熟方案
除非有特殊定制需求,否则优先考虑经过压测验证的库:
- bigcache:高性能、内存友好,基于分片 + ring buffer,支持 TTL,无 GC 压力
- freecache:比标准 map 内存节省 50%+,自带 LRU 和 TTL,API 简洁
- ristretto(by Dgraph):近似 LRU,吞吐极高,支持权重、成本感知驱逐,适合高负载服务
- 如需分布式一致性,再往上加一层如 Redis 或使用
groupcache做本地缓存 + 远程回源
基本上就这些。协程安全的缓存不复杂,但容易忽略 TTL 时序、锁粒度和空值处理。选对 工具 + 审慎设计 key 结构 + 小心 value 生命周期,就能稳住并发读写。