Kratos不提供自动多级缓存管理,需手动组合redis.Client等组件实现本地+Redis+DB三级缓存链路,推荐用ristretto或gcache替代sync.Map,并严格控制过期时间、空值标记与一致性策略。

Kratos 本身不提供本地缓存或多级缓存的自动管理能力,所有层级缓存都得你手动组合、显式控制——它只负责把 redis.Client、middleware、conf 这些“零件”给你,怎么搭成缓存流水线,是你自己的事。
本地缓存该用什么、怎么集成进 Kratos handler
Go 生态里没有 Caffeine 那种 Java 级别的本地缓存库,但你可以用 sync.Map 或更推荐的 github.com/dgraph-io/ristretto(高性能、带 LFU 淘汰)或 github.com/bluele/gcache(简单轻量)。Kratos 不限制你选哪个,但要注意:
- 别直接在 handler 里 new 一个全局
sync.Map就开用——没淘汰、没过期、没统计,容易内存泄漏 - 推荐封装成 struct field,比如
type UserService struct { localCache cache.Cache },在 service 初始化时注入 - 如果用
ristretto,务必设置MaxCost和NumCounters,否则默认会吃光内存;实测中NumCounters=1e7+MaxCost=1e9能稳住 2GB 内存水位 - 本地缓存 key 建议加前缀隔离,比如
"user:local:" + strconv.FormatInt(id, 10),避免和 Redis key 混淆
多级缓存读取逻辑必须手写,不能依赖框架自动降级
Kratos 不会帮你做「本地查不到→Redis 查→DB 查→回填两级」这种链路。你得在 service 层写清楚每一步,例如:
func (s *UserService) GetUser(ctx context.Context, id int64) (*v1.User, error) {
// 1. 查本地缓存
if u, ok := s.localCache.Get("user:local:" + strconv.FormatInt(id, 10)); ok {
return u.(*v1.User), nil
}
// 2. 查 Redis
val, err := s.redis.Get(ctx, "user:redis:"+strconv.FormatInt(id, 10)).Result()
if err == redis.Nil {
// 3. 查 DB,并写空标记防穿透
u, dbErr := s.dao.GetUserByID(ctx, id)
if dbErr != nil {
return nil, dbErr
}
if u == nil {
s.redis.SetEX(ctx, "user:redis:"+strconv.FormatInt(id, 10), "__NULL__", time.Second*120)
return nil, nil
}
// 回填 Redis
s.redis.SetEX(ctx, "user:redis:"+strconv.FormatInt(id, 10), proto.MarshalJSON(u), time.Hour)
// 回填本地
s.localCache.Set("user:local:"+strconv.FormatInt(id, 10), u, 5*time.Minute)
return u, nil
} else if err != nil {
return nil, err
}
// 反序列化并写入本地缓存
u := &v1.User{}
if err := json.Unmarshal([]byte(val), u); err != nil {
return nil, err
}
s.localCache.Set("user:local:"+strconv.FormatInt(id, 10), u, 5*time.Minute)
return u, nil
}
注意几个硬坑:
- 本地缓存过期时间(如
5*time.Minute)必须短于 Redis TTL(如time.Hour),否则本地可能长期滞留脏数据 - 空值标记
"__NULL__"要在 Redis 读取后立即判断,不能等反序列化失败才处理,否则 panic - 本地缓存写入不能放在 goroutine 里异步做——并发读写
ristretto或gcache会 panic
本地缓存失效与分布式一致性怎么破
本地缓存天然不一致:A 实例刚更新了用户昵称,B 实例的本地副本还缓着旧值。Kratos 没有内置广播机制,你得自己设计通知路径:
- 写操作后主动清理本机本地缓存:
s.localCache.Delete("user:local:" + strconv.FormatInt(id, 10)) - 同时发 Redis Pub/Sub 消息(如
DEL user:10086),其他实例订阅后也删本地缓存 —— 注意别用PUBLISH同步阻塞 handler,应走异步 goroutine - 对强一致性要求高的数据(如库存、余额),干脆别放本地缓存,只走 Redis + Lua 原子操作
- 如果用 Kafka 或 Nats,可以发「缓存失效事件」,但延迟更高,适合容忍秒级不一致的场景
真正难的不是代码怎么写,而是想清楚哪些数据能放进本地缓存——它不是性能银弹,而是业务语义的妥协。比如商品标题可以缓 5 分钟,但用户登录态 token 绝对不行;配置开关可以本地缓存 + 定时刷新,但订单状态变更必须实时穿透。











