go-zero 框架防止缓存击穿的核心做法是开启本地缓存的互斥锁(mutex)机制,而防止缓存雪崩则依赖于设置随机过期时间并配合全局熔断降级。具体而言,在 cache 配置中启用 mutexexpire 可以让多个并发请求共享一次后端查询,避免数据库被瞬间打满;同时为缓存 key 添加随机偏移量,确保数据不会在同一时刻集体失效。

cache 配置中如何开启互斥锁防击穿
在 Go-Zero 的 cache 结构体中,通过设置 MutexExpire 字段即可实现缓存击穿防护。当该值大于零时,如果缓存中没有数据,Go-Zero 会先获取一个基于 Key 生成的分布式锁(实际上是本地锁或 Redis 锁,取决于底层实现),然后由第一个请求去查询数据库,其他请求等待锁释放后直接读取新写入的缓存。这样即使高并发下缓存失效,也只有一个请求能穿透到数据库,其余请求都在内存层解决。

package main
import (
"context"
"fmt"
"time"
"github.com/zeromicro/go-zero/core/cache"
)
func main() {
// 定义缓存配置,关键是指定 MutexExpire
c := cache.CacheStore{
Redis: &cache.RedisConnInfo{
Host: "127.0.0.1:6379",
Type: "node",
},
// 设置互斥锁过期时间,例如 5 秒
// 在此期间内,只有第一个请求会执行 LoadFunc
MutexExpire: 5 * time.Second,
}
ctx := context.Background()
key := "user:1001"
// 定义加载函数:模拟从数据库查询
loadFunc := func(ctx context.Context, key string) (interface{}, error) {
fmt.Println("[DB Query] Executing for key:", key)
// 模拟数据库延迟
time.Sleep(100 * time.Millisecond)
return "User Data 1001", nil
}
var result interface{}
// GetEx 方法会自动处理互斥逻辑
_, err := c.GetEx(ctx, key, &result, loadFunc)
if err != nil {
fmt.Println("Error:", err)
return
}
fmt.Println("Result:", result)
}
上述代码展示了基本用法。运行程序时,如果并发调用 GetEx,控制台只会打印一次 [DB Query],证明互斥锁生效。若未设置 MutexExpire,每次缓存缺失都会触发 loadFunc,导致数据库压力激增。
如何设置随机过期时间防雪崩
缓存雪崩通常发生在大量 Key 在同一时间点集中过期,导致所有请求瞬间转向数据库。Go-Zero 本身没有自动为所有 Key 添加随机时间的内置开关,但开发者可以在存储缓存时手动计算过期时间。标准做法是将基础过期时间加上一个随机数(Jitter),例如 baseTTL + rand.Intn(maxJitter)。这样可以使 Key 的过期时间分散在一个时间窗口内,避免集体失效。

package main
import (
"context"
"math/rand"
"time"
"github.com/zeromicro/go-zero/core/cache"
)
func main() {
c := cache.New(cache.CacheConf{
Redis: &cache.RedisConnInfo{
Host: "127.0.0.1:6379",
Type: "node",
},
})
ctx := context.Background()
key := "product:5002"
value := "Product Info"
// 基础过期时间 10 分钟
baseTTL := 10 * time.Minute
// 随机抖动范围 0-5 分钟
jitter := time.Duration(rand.Intn(5)) * time.Minute
// 最终过期时间 = 基础时间 + 随机时间
finalTTL := baseTTL + jitter
// 存入缓存并设置动态过期时间
err := c.Set(ctx, key, value, finalTTL)
if err != nil {
fmt.Println("Set Error:", err)
return
}
fmt.Printf("Key %s will expire in approximately %v\n", key, finalTTL)
}
在实际业务中,建议将这种随机化逻辑封装在通用的 Cache Wrapper 中。结合 Go-Zzero 的 core/stores/redis 或 cache 模块,确保每个写操作都应用了不同的 TTL。此外,还可以配合使用 core/resilience 中的熔断器,当数据库响应变慢时自动切断对缓存的依赖,进一步保护系统稳定性。
当 MutexExpire 超时且数据库仍无数据时会发生什么
如果 MutexExpire 设置的时间内,持有锁的请求未能成功从数据库获取数据并写入缓存,或者数据库本身出现故障返回错误,那么等待中的其他请求将会收到相同的错误结果,而不是继续阻塞。此时,缓存中不会写入任何值(因为 loadFunc 返回了错误),后续请求再次命中缓存缺失,会重新尝试获取锁并查询数据库。这种机制确保了故障隔离,但可能导致短时间内重复查询失败,需配合重试策略或默认值处理。











