JedisCluster槽位缓存不会自动更新，仅在收到MOVED/ASK响应或主动调用refreshNodes()/flushCache()时刷新；需定期调用refreshNodes()或在异常重试中触发flushCache()来及时感知集群变更。
为什么 JedisCluster 初始化后第一次请求总超时或报 ASK/MOVED 错误
因为 JedisCluster 不在构造时拉取全量槽位映射，而是「懒加载」：首次执行命令时才向种子节点发 CLUSTER SLOTS，再根据响应构建本地 slot -> node 缓存。如果种子节点恰好不负责任何槽（比如是新加入的从节点），或网络抖动导致初始请求失败，就会卡住或抛异常。
实操建议：
- 确保传入的种子节点列表里至少有一个是当前集群中负责槽的主节点（
redis-cli -c -h seed_host -p seed_port CLUSTER NODES看master标识和 slot 范围） - 初始化时显式调用
jedisCluster.flushCache()触发一次拓扑刷新（适合测试环境快速验证） - 生产环境务必配置
maxRedirections（默认 5），避免因临时重定向失败直接中断 - 不要把哨兵地址、配置中心地址或 VIP 当作种子节点传进去——
JedisCluster只认真实 Redis 实例的host:port
JedisCluster 的槽位缓存多久更新一次？怎么让它及时感知集群变更
它不会自动轮询更新。缓存只在两种情况下刷新：一是收到 MOVED 或 ASK 重定向响应时，二是主动调用 refreshNodes() 或 flushCache()。这意味着扩容、缩容、failover 后，客户端可能持续发错节点，直到下一次重定向触发修正。
实操建议：
- 监听
ClusterTopologyRefresh类似逻辑（需自行封装）：定期（如每 30 秒）调用jedisCluster.refreshNodes()，但注意该方法是同步阻塞的，别在请求线程里高频调用 - 捕获
JedisConnectionException和JedisRedirectionException，在业务重试逻辑里加一层flushCache()，比被动等重定向更可控 - 避免在
JedisCluster实例上并发调用refreshNodes()，内部没有锁，可能引发ConcurrentModificationException
连接池配置不对，JedisCluster 会静默降级成单点访问
很多人只配了 JedisPoolConfig，却没意识到 JedisCluster 内部为每个种子节点维护独立连接池。如果 maxTotal 设得太小（比如 1），或 testOnBorrow 开启但节点响应慢，就可能导致部分节点连接池枯竭，后续请求 fallback 到其他节点甚至反复重试失败。
实操建议：
- 为每个物理节点预留至少 4–8 个连接（
maxTotal≥ 4），并设minIdle≥ 1 避免冷启动延迟 - 关闭
testOnBorrow（默认 false），改用testWhileIdle+timeBetweenEvictionRunsMillis周期性探活，减少每次命令的开销 - 确认
JedisCluster构造时传的是Set<hostandport></hostandport>，不是单个HostAndPort——后者会当作单机模式走Jedis分支，彻底绕过集群逻辑
升级 Redis 7+ 后 JedisCluster 报 NOAUTH Authentication required 却没设密码
Redis 7 默认启用 ACL，即使没设 requirepass，也会对集群命令（如 CLUSTER SLOTS）要求用户权限。而老版本 Jedis（≤ 4.3.x）构造 JedisCluster 时若未指定用户名，默认以 default 用户发起连接，但该用户默认无 cluster 权限。
实操建议：
- 检查 Redis ACL：
ACL LIST看default用户是否有~* & @cluster权限；没有就执行ACL SETUSER default ~* & @cluster - 升级到
jedis4.4.0+，支持构造时传String user参数，显式指定有权限的用户（如new JedisCluster(nodes, 2000, 2000, 5, "admin", password, poolConfig)） - 别在
redis.conf里留requirepass和acl-file并存，ACL 会覆盖传统密码机制，容易混淆认证路径
槽位缓存的生命周期和更新时机，是多数人调试时最晚意识到的问题——它不自动、不实时、不保证一致性，所有“应该自动发现”的预期，都得靠你主动补足那几行刷新逻辑。
