防Cacheable导致Redis雪崩，配置随机过期时间

Spring Boot 中 @Cacheable 默认不设过期时间，看似稳妥实则暗藏风险：一旦统一配置固定TTL，所有缓存key将严格同步过期，极易在流量高峰引发Redis雪崩；本文直击这一生产级陷阱，详解如何通过 RedisTemplate 手动注入随机偏移（如10分钟±60秒）实现平滑过期，并覆盖Lua批量补救、ThreadLocalRandom替代、系统key同步治理等实战细节，帮你避开高并发下缓存集体“断电”的致命雷区。

为什么 @Cacheable 默认会引发雪崩

因为 Spring 的 @Cacheable 在没显式指定过期策略时，根本**不设过期时间**——这看似安全，实则埋雷：一旦你后续通过 Redis CLI、运维脚本或别的客户端批量写入带 TTL 的数据（比如预热缓存），而这些 key 恰好又都用了相同固定时间（如 EX 600），那 10 分钟后它们就会集体“断电”，请求瞬间涌向数据库。

更隐蔽的是：哪怕你用 @Cacheable(cacheNames = "orders", key = "#id") + 自定义 RedisCacheConfiguration 统一配了 entryTtl(Duration.ofMinutes(10))，所有 key 还是会在写入时刻起严格按 10 分钟倒计时——上线后流量高峰一叠加，预热时间稍有集中，雪崩就来了。

怎么给 @Cacheable 加随机过期时间（Java 实操）

Spring Cache 本身不支持 per-key 随机 TTL，必须绕过默认配置，改用底层 RedisTemplate 手动控制写入逻辑。核心思路是：拦截缓存写入动作，在设置 value 时动态计算带偏移的过期时间。

• 别在 RedisCacheConfiguration 里设全局 entryTtl，它无法引入随机性
• 自定义一个 CacheManager，重写 getCache(String name)，返回包装过的 RedisCache
• 关键点：在缓存真正写入前，把原始 TTL（比如 10 分钟）替换成 10 * 60 + new Random().nextInt(60) 秒
• 示例片段（简化版）：

  redisTemplate.opsForValue().set(key, value, 
      Duration.ofSeconds(baseTtlSeconds + random.nextInt(60))); // 随机加最多 60 秒

用 Lua 脚本批量补随机 TTL 更稳妥吗

如果你已有大量存量 key（比如凌晨预热写入的 50 万个 user:123），临时改 Java 逻辑来不及，这时用 Lua 是可行的兜底方案——但要注意它只适合“补救”，不适合日常。

• Lua 脚本能保证原子性，避免 SCAN + 多次 EXPIRE 的网络开销和中间态风险
• 别直接用 redis-cli --eval 硬写，先在测试库验证脚本：

  local keys = redis.call('SCAN', 0, 'MATCH', 'user:*', 'COUNT', 1000)
  for i, key in ipairs(keys[2]) do
    local ttl = 600 + math.random(0, 59)
    redis.call('EXPIRE', key, ttl)
  end

• 线上执行前，务必加 SCAN 的 COUNT 限流，否则单次扫描太多 key 可能阻塞 Redis 主线程
• 注意：Lua 中 math.random() 在 Redis 7.0+ 才默认启用，老版本需先 CONFIG SET lua-time-limit 5000

容易被忽略的三个坑

随机不是万能解药，这几个细节不处理，照样雪崩：

• @Cacheable 方法如果抛异常，默认不写缓存——但你的随机 TTL 逻辑若没覆盖异常路径，会导致部分 key 永久无过期时间，长期堆积拖慢 Redis
• 用 new Random() 在高并发下可能生成重复种子（尤其容器环境），建议改用 ThreadLocalRandom.current().nextInt(60)
• 别只给业务 key 加随机，像分布式锁的 lock:order:123、布隆过滤器的 bloom:users 这类系统 key 也要单独评估——它们失效节奏不同步，反而可能成为新瓶颈

随机值的幅度得看业务容忍度：加 1 秒太毛毛雨，加 5 分钟又让缓存一致性变差。通常 1%~10% 基础 TTL 是较稳的区间，比如 30 分钟缓存，就加 0~180 秒。

今天关于《防Cacheable导致Redis雪崩，配置随机过期时间》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！