Redis缓存“动态刷新”指配置变更后缓存行为不重启生效，但@RefreshScope对RedisTemplate和CacheManager无效，因其被强引用；应通过@Value读取可刷新TTL配置并手动写入，或用@Scheduled定时重载数据，连接参数变更需服务发现或重启。
Spring Boot项目里，Redis缓存的“动态刷新”不是指自动轮询或监听数据库变更，而是指配置变更后，缓存行为（比如过期时间、序列化方式、连接参数）能不重启就生效。但@RefreshScope对RedisTemplate或CacheManager实例本身**无效**——这是最常踩的坑。
为什么@RefreshScope不能直接刷新RedisTemplate
@RefreshScope只作用于 Spring 容器中被 @Bean 标记的、且未被其他 Bean 强引用的单例对象。而 RedisTemplate 通常被 CacheManager、@Cacheable 代理、AOP 切面等强持有，刷新后旧实例仍在运行，新实例无法接管。
- 现象：改了
spring.redis.timeout或redis.cache.ttl，调用/actuator/refresh后连接超时没变、缓存过期时间也没更新 - 根本原因：
RedisTemplate是在应用启动时一次性构建并注入到所有依赖方的，刷新不会重建它所依赖的RedisConnectionFactory，也不会通知CacheManager重新初始化 - 替代方案：真正可刷新的，是业务层读取的配置项（如 TTL 值），再由你手动控制缓存写入逻辑
用@Value + 定时任务实现可刷新的 TTL 控制
把缓存过期时间抽成配置项，让业务代码在 set 时显式传入，这样改配置后只需刷新即可生效。
Redis Skill - 高性能缓存管理
下载
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
- 在
application.yml中定义：cache:<br/> user-ttl: 300
- Service 中注入：
@Value("${cache.user-ttl:300}") private long userTtl; - 写缓存时显式使用：
redisTemplate.opsForValue().set("user:123", user, userTtl, TimeUnit.SECONDS); - 配合
/actuator/refresh，下次写入就会用新值；但已存在的 key 不会自动延长过期时间，需靠后续写操作覆盖
定时刷新缓存内容（非配置，而是数据）
如果目标是定期重载某类缓存数据（比如字典表、配置项），而不是刷新 Redis 连接参数，那应该用 @Scheduled 主动重建缓存内容：
- 启用定时任务：
@EnableScheduling加到主类或配置类上 - 写一个刷新方法：
@Scheduled(fixedDelay = 300_000) // 每5分钟<br/>public void refreshSystemConfigs() {<br/> List<Config> configs = configMapper.selectAll();<br/> configs.forEach(c -> redisTemplate.opsForValue()<br/> .set("config:" + c.getKey(), c.getValue(), configTtl, TimeUnit.SECONDS));<br/>} - 注意：不要在
@Scheduled方法里直接调用@Cacheable方法——它走的是代理，可能绕过你的定时逻辑；应直接用RedisTemplate或 DAO 层查库再写缓存 - 避免多个实例同时刷新：加分布式锁（如
SET key value NX EX 30）或用@Scheduled配合 Leader 选举（如 Spring Cloud Zookeeper）
真正需要“动态连接参数”时，只能重启或换方案
如果你改的是 spring.redis.host、port、password 这类底层连接配置，/actuator/refresh 无法让 RedisConnectionFactory 重建连接池——Jedis/Lettuce 客户端不支持运行时切换 endpoint。
- 可行做法：用
RedisConnectionFactory的动态路由封装（如自定义DynamicRedisConnectionFactory，内部维护多个连接池，通过配置开关切换） - 更现实的选择：把 Redis 地址抽象为服务发现地址（如 Nacos 注册的
redis-cluster服务名），由 DNS 或服务网格层做故障转移，应用侧无感 - 别依赖
@RefreshScope刷新连接参数，它在这里只是个安慰剂
真正麻烦的从来不是“怎么写定时任务”，而是搞清你要刷新的到底是“配置值”“缓存内容”还是“连接本身”——三者技术路径完全不同，混用只会让问题更隐蔽。
