KCache-go本地缓存,支持本地缓存过期、缓存过期自维护机制。

GitHub - kocor01/kcache: go 本地缓存解决方案,支持本地缓存过期、缓存过期自维护机制。

最近系统并发很高,单接口10W的 QPS,对 redis 压力很大,大量的热KEY导致 redis 分片CPU资源经常告警。计划用 go 本地缓存缓解 redis 的压力。

有多个系统需要使用本地缓存,写了 KCache 方便各个系统使用。

本地压测达到 100W QPS。

使用请参考 使用实例

创建KCache

  • 创建一个KCache, 默认本地缓存过期时间 5s

    复制代码
    kc := New()
  • 创建一个KCache, 自定义本地缓存过期时间

    复制代码
    kc := NewWithExp(2 * time.Second)

获取缓存

  • GET 获取缓存,函数不带参数,本地缓存过期时间为创建 KCache 时设置的全局过期时间。

    复制代码
      kc := New()
      d := kc.Get("myKey", GetData())

    GET 方法包含两个参数,第一个参数为缓存的key,第二个参数为获取缓存数据的函数。当缓存不存在时,会调用函数获取数据,并将数据缓存起来。 函数需符合 GetKcDatafunc 类型、返回值需符合 KcData 类型。

    复制代码
    type GetKcDatafunc func() KcData
    
    type KcData struct { 
      interface{} 
      error
    }

    示例:

    复制代码
    // 获取缓存数据
    func GetData() GetKcDatafunc {
      return func() KcData {
        // sleep 模拟从 Redis、DB 中获取数据
        time.Sleep(20 * time.Millisecond)
    
        d := map[string]string{
          "k1": "value1",
          "k2": "value2",
        }
        return KcData{d: d, err: nil}
      }
    }
  • Get 获取缓存,函数带参数

    复制代码
    kc := New()
    params := map[string]string{
      "k1": "value1",
      "k2": "value2",
    }
    d := kc.Get("myKey", GetDataV2("myKey", params))

    示例:

    复制代码
    // 获取缓存数据
    func GetDataV2(key string, params map[string]string) GetKcDatafunc {
      return func() KcData {
        // sleep 模拟从 Redis、DB 中获取数据,也可以先从 redis 获取数据, 如果获取不到,再从 DB 中获取。
        time.Sleep(20 * time.Millisecond)
    
        data := make(map[string]string)
        for k, v := range params {
          data[k+key] = v
        }
        return KcData{d: data, err: nil}
      }
    }
  • GetWithExp 获取缓存,自定义本地缓存时间

    复制代码
    kc := New() 
    exp := 2 * time.Second
    params := map[string]string{
      "k1": "value1",
      "k2": "value2",
    }
    d := kc.GetWithExp("myKey", exp, GetDataV2("myKey", params))

GetKcDatafunc 实现

  • Kcache 中间函数(强烈推荐)

    通过 Kcache 中间函数调用原有的获取数据函数,该函数内部不含任何业务代码,减少业务代码与缓存代码的耦合。

    复制代码
    kc := New()
    exp := 2 * time.Second
    params := map[string]string{
      "k1": "value1",
      "k2": "value2",
    }
    d := kc.GetWithExp("myKey", exp, GetDataKcache("myKey", params))
    
    // 获取缓存数据, Kcache 中间函数
    func GetDataKcache(key string, params map[string]string) GetKcDatafunc {
      return func() KcData {
        data, err := GetDataV2(key, params)
        return KcData{Data: data, Err: err}
      }
    }
    
    // 获取数据
    func GetDataV2(key string, params map[string]string) (map[string]string, error) {
      // sleep 模拟从 Redis、DB 中获取数据,也可以先从 redis 获取数据, 如果获取不到,再从 DB 中获取。
      time.Sleep(20 * time.Millisecond)
      data := make(map[string]string)
        for k, v := range params {
        data[k+key] = v
      }
      return data, nil
    }
  • 闭包函数(推荐)

    简单获取数据的业务逻辑可以使用闭包函数。

    复制代码
    kc := New()
    params := map[string]string{
      "k1": "value1",
      "k2": "value2",
    }
    key := "myKey"
    fc := func() KcData {
      // sleep 模拟从 Redis、DB 中获取数据,也可以先从 redis 获取数据, 如果获取不到,再从 DB 中获取。
      time.Sleep(20 * time.Millisecond)
      data := make(map[string]string)
      for k, v := range params {
          data[k+key] = v
      }
      return KcData{Data: data, Err: nil}
    }
    d := kc.Get(key, fc)
  • 业务混合

    复制代码
    kc := New()
    d := kc.Get("myKey", GetData())
    
    // 获取缓存数据
    func GetData() GetKcDatafunc {
      return func() KcData {
        // sleep 模拟从 Redis、DB 中获取数据
        time.Sleep(20 * time.Millisecond)
        d := map[string]string{
          "k1": "value1",
          "k2": "value2",
        }
        return KcData{Data: d, Err: nil}
      }
    }

设置缓存

  • Set 设置缓存,本地缓存过期时间为创建 KCache 时设置的全局过期时间。

    正常情况下无需使用 Set 方法,因为 Get 方法会自动设置缓存。

    复制代码
    kc := New()
    params := map[string]string{
      "k1": "value1",
      "k2": "value2",
    }
    d := kc.Set("myKey", params)
  • SetWithExp 设置缓存,自定义本地缓存时间。

    正常情况下无需使用 SetWithExp 方法,因为 Get 方法会自动设置缓存。

    复制代码
    kc := New()
    exp := 2 * time.Second
    params := map[string]string{
      "k1": "value1",
      "k2": "value2",
    }
    d := kc.SetWithExp("myKey", params, exp)

删除缓存

  • Delete 删除本地缓存

    正常情况下无需使用 Delete 方法,因为有自动删除缓存机制。

    复制代码
    kc := New()
    params := map[string]string{
      "k1": "value1",
      "k2": "value2",
    }
    d := kc.Delete("myKey")

单纯使用本地缓存

  • 不需要自维护缓存数据

  • 底层使用的 go-cache,go-cache下的所有方法都可以使用。

    复制代码
    kc := New()
    // SET
    kc.lc.Set("myKey", "myValue", 2*time.Second)
    // GET
    d, f := kc.lc.Get("myKey")
    // other
    ...

更多使用案列请参考 使用实例

相关推荐
头顶秃成一缕光31 分钟前
Redis的主从模式和哨兵模式
数据库·redis·缓存
观无1 小时前
Redis安装及入门应用
数据库·redis·缓存
我的golang之路果然有问题2 小时前
速成GO访问sql,个人笔记
经验分享·笔记·后端·sql·golang·go·database
XY.散人3 小时前
初识Redis · 哨兵机制
数据库·redis·缓存
Pasregret5 小时前
缓存与数据库一致性深度解析与解决方案
数据库·缓存·wpf
M1A15 小时前
云原生第一步:Windows Go环境极速配置
后端·go
大家都说我身材好5 小时前
Spring缓存注解深度实战:3大核心注解解锁高并发系统性能优化‌
spring·缓存·性能优化
纪元A梦7 小时前
华为OD机试真题——推荐多样性(2025A卷:200分)Java/python/JavaScript/C++/C语言/GO六种最佳实现
java·javascript·c++·python·华为od·go·华为od机试题
Pasregret10 小时前
多级缓存架构深度解析:从设计原理到生产实践
缓存·架构
K8sCat11 小时前
Golang与Kafka的五大核心设计模式
后端·kafka·go