beego默认不启用redis缓存,需显式注册驱动、匹配配置名、规范conn格式、手动处理nil值与序列化,并自行实现原子get-or-create及错误捕获。

Beego 默认不启用 Redis 缓存,必须显式配置驱动、初始化实例,并注意序列化方式和连接参数——否则缓存写不进 Redis 或读出来是乱码。
redis 驱动注册和配置项必须匹配
Beego 的 cache 模块依赖 github.com/astaxie/beego/cache/redis 包,但仅引入不注册就无法使用。需在启动代码中 import 并触发 init:
- 必须写
import _ "github.com/astaxie/beego/cache/redis"(下划线不可省) -
app.conf中的配置段名要和驱动名一致:用redis作引擎名时,配置项必须叫redis,不是redis_cache或其他别名 - 配置字符串里
conn字段必须是host:port格式,不能带redis://前缀;dbNum是字符串(如"1"),不是整数
典型配置示例:{"key":"beego_cache","conn":"127.0.0.1:6379","dbNum":"0","password":"mypass"}
cache.Put() 写入 nil 值会失败,空结果需特殊处理
Redis 驱动底层调用 redigo 的 Do("SET", key, value),而 nil 会被序列化为 Go 的 nil,redigo 不支持直接 SET nil —— 这会导致 Put() 返回 nil 错误,但 Beego cache 层默认静默吞掉错误,现象是“写入成功但查不到”。
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis,支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
- 对空结果(如数据库查无此用户),应写入占位值,例如
cache.Put("user:123", []byte("NULL"), 300) - 避免用
cache.Put("user:123", nil, 300),它不报错但实际没存进去 - 反序列化时需判断值是否为
"NULL"字节数组,再转成业务层的空逻辑
Get() 返回 interface{},类型断言容易 panic
Beego cache 的 Get() 总是返回 interface{},且 Redis 驱动默认用 gob 编码,若你 Put 的是 struct,Get 后必须用相同类型断言,否则 runtime panic。
- 不要写
v := cache.Get("key").(string)—— 即使 Put 的是 string,gob 编码后取出来可能是[]byte - 推荐统一用
json.Marshal/Unmarshal手动序列化:Put 前data, _ := json.Marshal(obj),Get 后json.Unmarshal([]byte(v.([]byte)), &obj) - 如果坚持用 gob,确保 Put 和 Get 的 struct 定义完全一致(字段名、导出性、包路径),否则解码失败返回 nil
高并发下缓存击穿需自己加锁,cache 模块不提供原子 get-or-create
cache.IsExist() + cache.Get() 组合不是原子操作,在热点 key 过期瞬间,多个 goroutine 可能同时发现 key 不存在,然后一起回源 DB,造成击穿。
- Beego cache 没有
GetOrSet()或类似 Redis 的SETNX封装 - 必须自己用 Redis 原生命令实现:先
SET key val EX 300 NX,成功则回源并写缓存;失败则GET等待或重试 - 简单场景可用
sync.Once+ 内存标记兜底,但分布式部署时仍得靠 Redis 的SETNX或 redlock
最易被忽略的一点:Beego 的 Redis cache 驱动不会自动重连或处理连接中断,一旦 Redis 临时不可用,后续所有 Put/Get 都会静默失败——建议在关键路径加 if err != nil { log.Warn("cache op failed", err) } 显式捕获。










