GORM框架结合Redis实现二级缓存的方案-Golang-PHP中文网

gorm原生不支持二级缓存，因其仅负责单次数据库操作，无缓存生命周期管理、失效传播或多实例同步能力；二级缓存需在gorm外手动构建本地内存（如sync.map）与redis协同的读写逻辑，并严格保证写操作后同步清理两级缓存。

gorm框架结合redis实现二级缓存的方案

为什么GORM原生不支持二级缓存

GORM本身是面向单次请求的ORM层，它没有内置缓存生命周期管理、失效传播或多实例同步机制。你调用 db.First(&user, 1) 时，GORM只管查库、映射、返回——它不会主动去Redis里找，也不会在写入后通知其他服务“这条数据变了”。所谓“二级缓存”，其实是你在GORM之外手动补上的逻辑层。

本地内存 + Redis 的两级结构怎么搭

典型做法是：先查本地 map（如 sync.Map），命中就返回；未命中再查 Redis；Redis 也没命中才走 GORM 查库，查完顺手把结果写入 Redis 和本地 map。注意两点：

本地缓存必须带 TTL 控制，否则多实例部署时无法感知其他节点的数据变更
Redis 键名要统一前缀和序列化规则，比如用 user:123 而不是 users/123，避免不同模块冲突
写操作时，不能只删 Redis，还得清空本机的 sync.Map 对应项（否则下次读仍可能读到旧值）

示例片段：

redis-tools

按类别查找Redis命令、检测服务器连接、监控键数量和内存占用，支持离线速查表。

下载

func GetUserByID(ctx context.Context, id uint) (*User, error) {
    // 1. 查本地
    if val, ok := localCache.Load(fmt.Sprintf("user:%d", id)); ok {
        return val.(*User), nil
    }
    // 2. 查 Redis
    val, err := redisClient.Get(ctx, fmt.Sprintf("user:%d", id)).Bytes()
    if err == nil {
        var u User
        if err := json.Unmarshal(val, &u); err == nil {
            localCache.Store(fmt.Sprintf("user:%d", id), &u)
            return &u, nil
        }
    }
    // 3. 查 DB
    var u User
    if err := db.First(&u, id).Error; err != nil {
        return nil, err
    }
    // 4. 写两级缓存
    data, _ := json.Marshal(u)
    _ = redisClient.Set(ctx, fmt.Sprintf("user:%d", id), data, 10*time.Minute).Err()
    localCache.Store(fmt.Sprintf("user:%d", id), &u)
    return &u, nil
}