redis cluster 模式下 lettuce 无法开启读写分离,因协议强制所有请求经主节点路由,readfrom 策略仅在单机或哨兵模式生效;需弃用集群模式,改用哨兵或多实例直连实现从节点读。

Redis Cluster 模式下,Lettuce 客户端**无法开启读写分离**——这不是配置问题,而是协议层面的硬性限制。你配了 READONLY、加了从节点地址、甚至调用 slave.getConnection().setReadFrom(ReadFrom.REPLICA),只要底层用的是 LettuceClusterClient 或启用了集群模式(redis://...?ssl=false&cluster=true),所有读请求仍会被重定向到主节点。
为什么 lettuce.cluster 里 setReadFrom 不生效
因为 LettuceClusterClient 的路由逻辑完全基于 CLUSTER NODES 和 MOVED/ASK 响应,它压根不关心你设的 ReadFrom 策略。集群协议规定:任何对从节点的直接读请求,一旦被识别为集群模式连接,就会被主节点返回 MOVED 或直接拒绝。
-
ReadFrom.REPLICA只在单机或哨兵模式(RedisClient+SentinelProvider)下起作用 - 集群模式下,
Lettuce会忽略setReadFrom,强制走哈希槽路由 - 即使你手动用
StatefulRedisConnection连某个从节点 IP:port,只要 URI 含cluster=true或使用了RedisClusterClient,连接初始化就会失败或降级为只连主节点
想用 lettuce 读从节点,必须放弃集群模式
核心是绕过集群协议,改用「多实例直连 + 手动分片」或「哨兵模式」:
- 如果已有稳定主从拓扑(比如 1 主 + 2 从),且没启用
cluster-enabled yes,就用RedisClient分别创建连接:masterConn写,slaveConn调用.executeCommand("READONLY")后读 - 如果用了哨兵,用
SentinelClient获取当前主节点地址,再用SentinelProvider构建支持ReadFrom.REPLICA的RedisClient - 不要在
application.yml里写spring.redis.cluster.nodes=...,否则 Spring Boot 自动装配的就是LettuceClusterClient,后续所有自定义都白搭
示例(哨兵模式下启用从节点读):
RedisClient client = RedisClient.create("redis-sentinel://127.0.0.1:26379,127.0.0.1:26380/stock-sentinel");
StatefulRedisMasterSlaveConnection<string string> connection = MasterSlave.connect(client,
new Utf8StringCodec(),
RedisURI.create("redis-sentinel://127.0.0.1:26379/stock-sentinel"));
connection.setReadFrom(ReadFrom.REPLICA_PREFERRED);
</string>
强行在集群上“模拟”读写分离的代价
有人尝试改 JedisCluster 源码或套一层 redis-proxy(如 Codis、Twemproxy),但对 Lettuce 来说这条路更难走:
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis,支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
- 要自己解析
CLUSTER SLOTS,维护主从映射表,并监听CLUSTER NODES变更(故障转移后从变主、主变从) - 每次读前得查 key 对应的 slot,再找该 slot 当前的 replica 列表——而
CLUSTER NODES不直接暴露哪些节点是 replica,得靠flags字段解析(slave、myself,slave) - 没有自动 failover 感知,一个从节点宕机,你的读请求就
Connection refused,除非集成 Sentinel 或自己轮询健康检查
简单说:不是不能做,而是你要承担原本由集群客户端封装好的那部分状态同步逻辑。
Spring Boot + Lettuce 配置最容易踩的坑
很多人以为改个配置就能开读写分离,结果全掉进这几个默认行为里:
-
spring.redis.cluster.max-redirects=5—— 这个值会让客户端默默重试 5 次MOVED,掩盖了“读请求其实没走从节点”的事实 -
spring.redis.lettuce.cluster.refresh.period=60000—— 默认每分钟拉一次集群拓扑,但不会刷新 replica 状态,从节点上线/下线后,旧连接还在往已下线的 IP 发请求 - 用
@Bean RedisTemplate时没指定RedisConnectionFactory类型,Spring Boot 自动注入的是LettuceClusterConnection,哪怕你代码里写了ReadFrom.REPLICA,也根本没机会执行 - 在集群模式下执行
slave.executeCommand("READONLY"),返回(error) ERR unknown command 'readonly'—— 因为集群模式禁用了该命令
真正可行的路径只有一条:确认你不需要 Redis Cluster 的自动分片和 slot 迁移能力,那就关掉 cluster-enabled,回归主从+哨兵,让 Lettuce 的 ReadFrom 策略自然生效。否则,所谓“集群读写分离”,本质是在对抗协议设计。










