如何使用Beego框架实现Redis缓存-Golang-PHP中文网

beego 的 cache/redis 模块易踩坑，推荐直接使用 go-redis 或 redigo；配置需严格符合 json 格式，字段名固定为 key、conn、dbnum、password，且 dbnum 和 password 需为字符串并 url 编码；并发下 isexist+get 非原子，结构体序列化隐式且不一致，应自行控制序列化与缓存逻辑。

如何使用beego框架实现redis缓存

Beego 自带的 cache 模块支持 Redis，但直接用它容易踩坑：比如配置格式错一个字符就初始化失败、Get/Put 对非字符串值自动序列化不一致、并发下 IsExist 和 Get 不是原子操作。推荐绕过 cache 模块，用 go-redis 或 redigo 直接对接 Redis，更可控。

beego 配置 Redis 连接信息要严格匹配 redigo 的 JSON 格式

Beego 的 cache/redis 驱动底层用的是 redigo，它要求配置字符串必须是合法 JSON，且字段名固定为 key、conn、dbNum、password。常见错误是：

把 conn 写成 address 或 host —— 会静默失败，NewCache 返回 nil
dbNum 写成数字 0 而不是字符串 "0" —— 解析失败，报错 json: cannot unmarshal number into Go struct field Config.dbNum of type string
密码含特殊字符（如 @、/）没做 URL 编码 —— 连接时被截断，报 invalid password

正确写法示例（放在 conf/app.conf 中）：

redis::address = "127.0.0.1:6379"
redis::database = "0"
redis::password = "mypass%40123"  # @ 编码为 %40
redis::key = "beego_cache"

然后在代码中加载：

import (
    "github.com/astaxie/beego/cache"
    _ "github.com/astaxie/beego/cache/redis"
)
bm, _ := cache.NewCache("redis", `{"key":"beego_cache","conn":"127.0.0.1:6379","dbNum":"0","password":"mypass%40123"}`)

用 go-redis 替代 beego/cache 更适合复杂缓存逻辑

如果你需要 TTL 精确控制、Pipeline、Lua 脚本或连接池自定义，go-redis 是更现代的选择。Beego 不强制绑定 redigo，完全可以自己初始化客户端：

安装：go get github.com/go-redis/redis/v9
初始化时用 Beego 配置读取参数，避免硬编码：beego.AppConfig.String("redis::address")
注意上下文（context.Context）传入：所有 Set/Get 必须带 ctx，超时需显式控制
不要在每个请求里新建 client —— 全局复用一个 *redis.Client 实例即可

简单示例：

Redis Skill - 高性能缓存管理

Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。

下载

import "github.com/go-redis/redis/v9"
var redisClient *redis.Client
func init() {
    addr := beego.AppConfig.String("redis::address")
    pwd := beego.AppConfig.String("redis::password")
    db, _ := beego.AppConfig.Int("redis::database")
    redisClient = redis.NewClient(&redis.Options{
        Addr:     addr,
        Password: pwd,
        DB:       db,
    })
}
// 使用
ctx := context.Background()
err := redisClient.Set(ctx, "user:123", "name:alice", 10*time.Minute).Err()