单独开启spring.redis.lettuce.cluster.refresh.adaptive=true无效，因其依赖MOVED/ASK等事件触发，而静默下线或网络丢包时事件不发生；必须配合spring.redis.lettuce.cluster.refresh.period=60s周期刷新兜底，确保拓扑不过期。
为什么spring.redis.lettuce.cluster.refresh.adaptive=true单独开没用
只配自适应刷新，不配周期刷新，Lettuce 在首次连接后仍可能长期卡在旧拓扑里。比如集群刚完成主从切换，但客户端没收到 MOVED 响应（因为请求压根没打到需要重定向的 slot），就不会触发刷新；又或者网络抖动导致重定向包丢失，自适应机制就彻底失效。它依赖“事件触发”，而事件不一定发生。
必须配合 spring.redis.lettuce.cluster.refresh.period 才能兜底：哪怕什么异常都没报，每 60 秒也会强制拉一次 CLUSTER NODES 和 CLUSTER SLOTS，确保本地缓存不过期。
-
spring.redis.lettuce.cluster.refresh.adaptive=true开启后，会在收到MOVED、ASK、连接断开、持续重连失败等场景下立即刷新 -
spring.redis.lettuce.cluster.refresh.period=60s是硬性保底，防止“静默过期”——这是生产环境最常被忽略的一环 - 两个参数缺一不可，Spring Boot 2.3+ 才支持纯配置开启，2.2 及更早需写 Java 配置类手动构造
ClusterTopologyRefreshOptions
spring.redis.lettuce.cluster.refresh.period 设太小会怎样
设成 5s 或 10s 看似更“及时”，实际会反向拖垮集群稳定性。Lettuce 每次周期刷新都会并发向所有已知节点发送 CLUSTER NODES 请求，若刷新太频繁，可能在节点数多（如 12 节点集群）时引发大量无意义的控制面流量，加重 Redis 节点 CPU 和网络负担，甚至触发慢日志或连接拒绝。
官方推荐值是 60s，兼顾时效与开销。如果你的集群变更极频繁（如灰度扩缩容每小时多次），可降至 30s，但务必观察 Redis 的 instantaneous_ops_per_sec 和 rejected_connections 指标是否异常升高。
- 低于
15s属高风险配置，不建议线上使用 - 超过
120s则可能错过故障窗口，比如主从切换后 90 秒内新请求仍打到下线节点 - 该参数单位是秒，配置时必须带单位，如
60s，不能写60（否则会被解析为毫秒）
集群节点地址写错一个，会导致拓扑刷新完全失效
Spring Boot 启动时，Lettuce 会从配置的 seed nodes 中随机选一个建立初始连接，并拉取完整拓扑。如果 seed list 里混入了已下线、防火墙屏蔽、或 DNS 解析失败的地址（比如 redis-node-4:6379 实际已销毁），Lettuce 默认行为是**静默跳过该节点，继续尝试下一个**——但一旦所有 seed 都不可达，它不会抛出明确异常，而是 fallback 到一个空拓扑，后续所有命令都可能路由失败。
典型现象是应用启动成功、健康检查通过，但第一个 Redis 请求就报 java.lang.IllegalArgumentException: Connection to X not allowed. This connection point is not known in the cluster view。
- seed nodes 应至少填 3 个稳定在线的主节点地址，避免单点故障
- 不要把从节点加进 seed list（Lettuce 会自动发现从节点，但 seed 只需主）
- 上线前用
redis-cli -c -h xxx -p xxx CLUSTER NODES逐个验证 seed 地址是否可达且返回有效拓扑
升级到 Redis 8.2.3 后，拓扑刷新配置要不要改
不用改，但必须做兼容性确认。Redis 8.2.3 修复了 CVE-2025-62507（RCE 漏洞）和 HyperLogLog 崩溃问题，但其 CLUSTER NODES 响应格式、重定向语义、槽位迁移协议均保持向前兼容。Lettuce 6.3.x 及以上版本（Spring Boot 2.7+ 自带）已适配该版本。
真正要警惕的是：升级后若未同步更新 Lettuce 客户端，旧版（如 6.1.x）可能在解析新版集群元数据时出现静默截断或映射错乱，表现为部分 slot 路由到错误节点，且无明显报错。
- Spring Boot 2.7+ 默认集成 Lettuce 6.3+，可直接用
- Spring Boot 2.6.x 建议手动升级
io.lettuce:lettuce-core至6.3.2.RELEASE或更高 - 升级后务必跑一次全链路压测，重点观察
MOVED错误率和cluster_key_count分布是否均匀
