Go语言Gin框架使用Go-Cache实现本地内存高速缓存-Golang-PHP中文网

不推荐在gin中将go-cache作为全局单例直接使用，因为cache.new()返回的struct含非导出字段且内部启动janitor goroutine，若在handler中反复创建会累积goroutine导致栈溢出或内存泄漏；正确做法是应用启动时初始化一次并通过gin.engine.use()注入全局访问。

go语言gin框架使用go-cache实现本地内存高速缓存

为什么 Gin 里直接用 `go-cache` 不推荐做全局单例？

因为 go-cache 的 cache.New() 返回的是非导出字段的 struct，它内部启动了一个 janitor goroutine 定期清理过期项；如果在 Gin 的中间件或 handler 里反复创建实例，会累积大量 goroutine，最终触发 runtime: goroutine stack exceeds 1GB limit 或内存泄漏。

正确做法是：应用启动时初始化一次，通过 gin.Engine.Use() 注入为全局可访问对象。常见错误包括：

在每个 handler 里 cache.New(...) —— 每次请求都启一个 janitor
把 *cache.Cache 存在 c.Keys 里再取 —— 类型断言易错，且生命周期难控
用 sync.Once 包裹 New() 却忘了传参一致性 —— 默认过期时间和清理间隔一旦写死就无法按场景区分

`gin.Context` 中安全存取 `go-cache` 值的关键点

Gin 本身不提供缓存抽象层，所以你要自己把 *cache.Cache 绑定到 *gin.Engine 上，而不是塞进 Context。典型结构如下：

var cacheInst *cache.Cache
<p>func initCache() {
cacheInst = cache.New(5<em>time.Minute, 10</em>time.Minute)
}</p><p>func main() {
r := gin.Default()
initCache()
r.Use(cacheMiddleware)
r.GET("/user/:id", getUserHandler)
r.Run()
}
</p>

然后在 handler 里直接用 cacheInst.Get()，不要试图从 c 里取缓存实例。如果你非要挂载到 Context（比如多租户隔离场景），必须确保：

只在中间件中调用 c.Set("cache", cacheInst) 一次
后续所有 handler 都用 c.MustGet("cache").(*cache.Cache)，不能漏掉类型断言
禁止在中间件外修改 cacheInst 的配置（如调用 SetDefaultExpiration），它不是线程安全的配置操作

`Set` 和 `Get` 在高并发下容易丢数据？

go-cache 的 Set/Get 是线程安全的，但「安全」不等于「强一致」。典型问题出现在「读-改-写」流程中，比如计数器：

Gin框架 1.9.0

Gin框架 1.9.0版本源码包下载，版本号 1.9.0，适合需要 sonic JSON 支持、路由修复和内容协商改进的 Go Web 开发场景。

下载

v, ok := cacheInst.Get("counter")
if !ok {
    v = 0
}
cacheInst.Set("counter", v.(int)+1, cache.DefaultExpiration) // ❌ 竞态

这种写法在并发请求下会丢失更新。正确方式是用内置原子操作：

数值类：用 cacheInst.Increment("counter", 1) 或 cacheInst.IncrementInt64("counter", 1)
非数值类：必须加外部锁（sync.RWMutex）或换 singleflight.Group 防穿透
注意：Increment 要求初始值已存在且是数字类型，否则 panic

缓存击穿和雪崩怎么防？`go-cache` 自身不解决

go-cache 是纯内存结构，没有分布式协调能力，也不支持 key 级别锁或回源保护。当多个 goroutine 同时发现 key 不存在并去查 DB，就会造成击穿；如果大量 key 同时过期，就是雪崩。

你必须自己补足这一环：

击穿：用 singleflight.Group 包裹实际加载逻辑，Do(key, fn) 确保同一 key 只有一个 goroutine 查库
雪崩：避免所有 key 使用相同过期时间，可在 Set 时加随机偏移，例如 time.Duration(rand.Int63n(60)) * time.Second
注意：go-cache 的 janitor 清理是异步的，DeleteExpired() 是同步阻塞调用，别在 handler 里频繁手动触发

最常被忽略的一点：go-cache 的过期判断基于写入时间，不是访问时间；它不支持 LRU 或 LFU 淘汰策略，内存增长只靠过期和手动 Flush() 控制——如果你缓存的是大对象（比如 []byte 超 1MB），得自己监控 runtime.ReadMemStats 防 OOM。