如何在 Go 中实现二级缓存（本地缓存 + Redis）？-Golang-PHP中文网

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

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

本地缓存用 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 再本地）本质是“降级缓存”，本地反而成了兜底，失去性能优势。

Redis Skill - 高性能缓存管理

Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 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")，否则下次读仍可能从本地拿到旧值