如何在 Go 中实现二级缓存（本地缓存 + Redis）？

Golang不知道大家是否熟悉？今天我将给大家介绍《如何在 Go 中实现二级缓存（本地缓存 + Redis）？》，这篇文章主要会讲到等等知识点，如果你在看完本篇文章后，有更好的建议或者发现哪里有问题，希望大家都能积极评论指出，谢谢！希望我们能一起加油进步！

sync.Map适合读多写少、无过期淘汰需求的轻量场景，如配置热更新；需TTL、LRU或容量控制时应选gcache、bigcache、freecache或ristretto等第三方库。

本地缓存用 sync.Map 还是第三方库？

直接用 sync.Map 是最轻量、最可控的选择，尤其适合读多写少、key 稳定的场景（比如配置项、用户权限白名单）。它原生支持并发安全，不依赖额外依赖，也不引入 GC 压力或淘汰逻辑干扰。

但注意：sync.Map 没有容量限制、没有过期机制、不支持自动驱逐。如果你需要 LRU、TTL 或内存用量控制，就得换方案——比如 github.com/bluele/gcache 或自己封装带定时清理的 map[interface{}]struct{value interface{}; expireAt time.Time}。

常见踩坑点：

• 误把结构体值直接塞进 sync.Map：如果结构体含指针或 map/slice，后续修改会意外影响缓存值；建议只存不可变类型或深拷贝后存
• 用 LoadOrStore 时传入函数体未加锁：若函数内含 DB 查询或 Redis 调用，多个 goroutine 同时触发会导致重复加载；得在外层加单例锁（如 singleflight.Group）

Redis 缓存键怎么设计才不容易冲突？

别用裸 ID 当 key，比如 "123" —— 不同业务表可能共用相同数字 ID，一删就串。

推荐格式："user:profile:123"、"order:summary:20260424:uid_789"。前缀明确语义，中间段可嵌入时间、租户、版本等维度，便于运维排查和批量清理。

关键细节：

• 所有 key 必须统一编码：用 encoding/json 序列化结构体后存 Redis，而不是 fmt.Sprintf 拼接字符串——后者对空字段、浮点精度、嵌套 map 处理不可靠
• 避免在 key 中拼接用户输入（如用户名），需先做 strings.ReplaceAll(username, ":", "_") 防止冒号破坏分段语义
• 如果用 hash 结构（如 HSET user:123 name "Alice" age "30"），记得配套用 HGETALL + redis.StringMap 解析，别用 redis.Strings 得到错位数组

查缓存时“先本地再 Redis”还是“先 Redis 再本地”？

优先走本地缓存，再 fallback 到 Redis —— 这才是严格意义上的“二级缓存”。顺序反了（先 Redis 再本地）本质是“降级缓存”，本地反而成了兜底，失去性能优势。

典型流程应是：

• 请求进来 → 查 sync.Map.Load("user:123")
• 命中则直接返回；未命中 → 查 Redis（GET user:profile:123）
• Redis 命中 → 反序列化 + 写回本地（Store）→ 返回
• Redis 未命中 → 查 MySQL → 序列化 → 写 Redis（带 EX 60）→ 写本地 → 返回

容易忽略的点：

• 本地缓存写入时机：不能只在 Redis 命中时写，必须在“最终加载成功后”统一写，否则 Redis 击穿时本地永远为空
• 本地缓存 TTL：即使 Redis 有 60 秒过期，本地也建议设更短（如 30 秒），防止 Redis 故障期间本地长期脏数据

如何避免缓存与数据库不一致？

写操作（增删改）时，**必须删除对应缓存，而不是更新**。因为更新需要重查 DB、重序列化、重写 Redis，而删除是幂等、轻量、确定性操作。

例如用户资料更新后，执行：

redisClient.Del(ctx, "user:profile:123")
redisClient.Del(ctx, "user:summary:123")

而不是：

// ❌ 错误：DB 和 Redis 更新不同步风险极高
newData := loadFromDB(123)
redisClient.Set(ctx, "user:profile:123", newData, 60*time.Second)

补充策略：

• 删除缓存失败不能阻塞主流程，要异步重试（比如发到本地 channel 由后台 goroutine 重试）
• 敏感数据（如余额、库存）可加「延迟双删」：更新 DB 前删一次，更新 DB 后 sleep 100ms 再删一次，覆盖主从延迟窗口
• 本地缓存删除也要同步做：syncMap.Delete("user:123")，否则下次读仍可能从本地拿到旧值

理论要掌握，实操不能落！以上关于《如何在 Go 中实现二级缓存（本地缓存 + Redis）？》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！