不推荐直接用 sync.Map + 定时清理实现带 TTL 的缓存,因易引发竞态、内存泄漏及清理不及时;建议优先选用 go-cache 等成熟库,或组合 time.Timer 与 sync.Map 实现轻量方案。

用 sync.Map + 定时清理能跑,但不推荐直接这么干
Go 标准库没有内置带过期的缓存,sync.Map 本身不支持 TTL,硬加时间戳字段再配 goroutine 扫描删除,会引入竞态和内存泄漏风险——比如某个 key 被高频更新,旧的过期条目可能永远等不到被清理。
实操建议:
- 不要自己写定时轮询扫描全量 map 的逻辑,清理开销随数据量线性增长,且无法保证精确过期
- 避免为每个 entry 启一个
time.AfterFunc,大量短生命周期 key 会导致 goroutine 泛滥 - 优先考虑组合已有成熟机制:用
time.Timer延迟执行 +sync.Map原子操作,或直接用golang.org/x/exp/maps(仅限实验性场景)
github.com/patrickmn/go-cache 是最省心的落地选择
这个库在中小规模服务中稳定运行多年,API 简洁,内部用 map + sync.RWMutex 实现,过期检查发生在读写路径上,不依赖后台 goroutine 扫描。
典型用法:
import "github.com/patrickmn/go-cache"
c := cache.New(5*time.Minute, 10*time.Minute) // 默认过期 + 清理间隔
c.Set("key", "value", cache.DefaultExpiration)
v, found := c.Get("key")
注意点:
-
cache.New第二个参数是清理 goroutine 的触发周期,不是 key 过期精度;实际过期判断在Get或Set时惰性触发 - 如果只写不读,过期 key 可能滞留直到下一次清理周期或显式调用
c.DeleteExpired() - 不支持 CAS 操作(如 compare-and-swap),高并发写同 key 时以最后写入为准
自己实现最小可行版:用 sync.Map 存 struct{ value interface{}; expireAt time.Time }
如果项目禁止第三方依赖,且缓存规模可控(
核心逻辑:
- 每次
Get都检查expireAt.Before(time.Now()),过期则Delete并返回未命中 -
Set时把time.Now().Add(ttl)写入结构体,不启动任何额外 goroutine - 避免在
Get中做time.Now()调用热点?可传入func() time.Time用于测试 mock,生产环境仍用系统时钟
示例片段:
type Item struct {
value interface{}
expireAt time.Time
}
type Cache struct {
m sync.Map
}
func (c *Cache) Set(key string, value interface{}, ttl time.Duration) {
c.m.Store(key, Item{
value: value,
expireAt: time.Now().Add(ttl),
})
}
func (c *Cache) Get(key string) (interface{}, bool) {
if v, ok := c.m.Load(key); ok {
item := v.(Item)
if time.Now().Before(item.expireAt) {
return item.value, true
}
c.m.Delete(key) // 过期即删,避免下次再查
}
return nil, false
}
Redis 作为后端时,别在 Go 层重复实现 TTL 逻辑
如果缓存已用 Redis,SET key value EX 60 或 SETEX 命令原生支持过期,Go 客户端(如 github.com/go-redis/redis/v9)直接透传即可。
常见错误:
- 在 Go 内存里再维护一套过期时间,和 Redis 实际状态不同步,导致“缓存击穿”或“脏读”
- 用
GET+ 自己算时间判断是否过期,忽略了 Redis 返回 nil 表示 key 已不存在(含已过期) - 误以为
ttl命令返回 -2 就是 key 不存在,其实 -1 表示无过期设置,-2 才是不存在——应直接信任 GET 结果
正确姿势:所有过期逻辑交给 Redis,Go 层只做命令转发和错误处理。本地加一层 sync.Map 做 short-circuit(比如 100ms 级别热点),但必须设极短 TTL(如 100ms),且不与 Redis 过期耦合。











