cache

cache

Redis 相关能力分两层：

RedisContext

EnableCache 启动后会注册 RedisSession；业务使用：

r := app.GetRedis()
val, err := r.Get(ctx, "key")
if cache.IsNotFound(err) {
    // key 不存在（内部已映射 redis.Nil）
}
_ = r.Set(ctx, "key", "value", time.Minute)
_ = r.Publish(ctx, "app:logs", line)

或使用对称 helper：

app.Redis(func(r cache.RedisContext) error {
    return r.Set(ctx, "k", "v", time.Minute)
})

错误处理

两条路径，不要混用判断函数

框架 API 在 redis_session.go、redis.go 出口统一调用 NormalizeErr：不会把 redis.Nil 原样抛给业务。

cache.ErrNotFound 是包内归一化哨兵（errors.New("cache: not found")），供 NormalizeErr 返回、IsNotFound 比较。业务不必也不应手写 errors.Is(err, cache.ErrNotFound)，统一走下方工具函数。

工具函数（cache/errors.go）

示例

走框架（推荐）：

val, err := app.GetRedis().Get(ctx, "key")
if cache.IsNotFound(err) {
    // key 不存在
}

直接用 go-redis（少数场景）：

val, err := client.Get(ctx, "key").Result()
if cache.IsRedisNil(err) {
    // key 不存在
}

业务不要 import "github.com/redis/go-redis/v9" 判断 redis.Nil；走框架用 IsNotFound，直连 driver 用 IsRedisNil。