单机缓存需按并发写压力选型:写入超200 QPS必须用cache.NewSharded(如64分片),读多写少可用cache.New;cache.NoExpiration非真正永存,仍受GC和Flush影响;Get后必须用found判断再断言,避免panic;后台清理惰性执行,需结合Get时检查与合理间隔配置。

直接用 cache.New 还是该上分片?看并发写压力
单机缓存不是“建个 cache.New 就完事”。如果你的业务每秒写入超 200 次(比如用户登录态频繁刷新、实时计数器更新),cache.New 返回的普通缓存会卡在 sync.RWMutex 上——所有写操作串行排队,CPU 利用率虚高但吞吐不涨。
这时必须切到分片缓存:cache.NewSharded。它把 key 哈希后分散到 32 或 64 个独立子缓存里,每个子缓存自带锁,写操作天然并行。
实操建议:
- 写密集场景(如订单状态变更、库存扣减):固定用 cache.NewSharded(64, 5*time.Minute, 10*time.Minute)
- 读远多于写(如配置加载、地区字典):cache.New 足够,RWMutex 读不加锁,性能反而更稳
- 别硬套“分片越多越好”:超过 128 分片后,哈希冲突下降收益趋近于零,但内存开销和 GC 压力明显上升
Set 时传 cache.NoExpiration 真的永不过期?
不是。“永不过期”只表示不参与自动清理,但依然受内存约束和手动操作影响。
常见错误现象:
- 缓存项突然消失,查日志没删操作,也没过期
- Get 返回 (nil, false),但 cache.Items() 里还能看到这个 key
根本原因:go-cache 的 Items() 返回的是当前 map 快照,而实际清理靠后台 goroutine 扫描 expireAt 字段——如果用了 cache.NoExpiration,这个字段是 0,扫描逻辑直接跳过,但它仍占内存;一旦触发 GC 或手动调用 c.Flush(),这些“永存”项就没了。
实操建议:
- 静态配置类数据,确实用 cache.NoExpiration,但务必配合 c.Set("config:db", cfg, cache.NoExpiration) 显式设置,别依赖默认值
- 所有带业务含义的“长期缓存”,建议设一个很长但非零的 TTL,比如 24 * time.Hour,避免被误判为垃圾
- 别在生产环境依赖 Items() 判断 key 是否“一定存在”,它只是快照,不是权威状态
为什么 Get 后必须做类型断言,且不能省略 found 判断?
因为 cache.Get 返回 interface{} 和布尔值,Go 不做隐式转换,漏掉 found 会导致 panic 或静默错误。
典型翻车现场:
- user := c.Get("user:123").(*User) —— key 不存在时返回 nil,强制解引用直接 panic
- if user := c.Get("user:123"); user != nil { ... } —— nil interface{} 和 nil pointer 不等价,判断失效
实操建议:
- 永远按标准写法:if val, found := c.Get("key"); found { x := val.(Type) }
- 结构体优先存指针:c.Set("user:123", &u, ttl),避免值拷贝,也减少断言时的类型歧义
- 基本类型(int/bool/string)可直接断言,但复杂嵌套结构(如 map[string]interface{})建议封装成自定义 struct 再存,类型安全更可控
后台清理 goroutine 每 10 分钟扫一次,真能及时清掉过期项?
不能。清理是惰性的,依赖定时扫描 + Get 时顺手检查,两者缺一不可。
如果你只靠后台 goroutine,过期项可能滞留长达清理间隔(默认 10 分钟);而如果只靠 Get 检查,冷数据永远不被访问,内存就一直涨。
性能影响很实际:
- 清理间隔设太短(如 30 秒):goroutine 频繁抢锁,尤其在 key 数量 > 10 万时,CPU 毛刺明显
- 清理间隔设太长(如 1 小时):内存占用不可控,OOM 风险上升
实操建议:
- 默认 10 分钟可接受,但需监控 cache.ItemCount() 趋势,若持续上涨,说明冷 key 太多,得调低间隔或加主动淘汰逻辑
- 关键业务(如 token 校验)在 Get 后立刻加一层时间判断:if expireAt, ok := val.(time.Time); ok && expireAt.Before(time.Now()) { c.Delete(key) }
- 别动源码去改 janitor 的扫描逻辑——它用随机采样(默认 1%)避免全量遍历,这是平衡性能和精度的合理取舍
立即学习“go语言免费学习笔记(深入)”;


















