Spring Boot 2.7中Redis无内置多节点负载均衡,需按部署模式选择:集群模式用spring.redis.cluster.nodes配置master节点并设max-redirects,主从/哨兵模式通过Lettuce的read-from=REPLICA_PREFERRED实现读负载,连接池参数不控制节点分发。

Spring Boot 2.7 中 Redis 本身不提供“多节点负载均衡”这种抽象概念——它只有明确的部署模式:单机、主从、哨兵、集群。所谓“负载均衡”,实际是不同模式下由客户端(Lettuce)按策略分发请求的行为,不能靠配置几个 IP 就自动实现。关键得先选对模式,再配对参数。
用 spring.redis.cluster.nodes 配集群才是真分片负载
如果你的目标是让读写请求分散到多个物理节点上,并且数据也自动分片,那必须走集群模式。主从或哨兵的“读写分离”只是把读请求打到从节点,写仍全走主节点,不算真正意义上的多节点负载。
-
spring.redis.cluster.nodes必须填所有 master 节点地址(不能混入 slave),格式严格为host:port,例如192.168.1.101:7001,192.168.1.102:7002 - 删掉所有
spring.redis.host、spring.redis.port、spring.redis.sentinel.*等残留配置,否则 Spring Boot 会因配置优先级误判模式 - 必须设
spring.redis.cluster.max-redirects,值建议等于 master 节点数;不设就卡在 MOVED/ASK 异常里 - 密码统一用
spring.redis.password,所有节点密码必须一致,且不能含逗号、空格、斜杠
用 read-from: REPLICA_PREFERRED 实现主从/哨兵下的读负载
主从或哨兵模式下,真正的负载只发生在读请求。Lettuce 通过 read-from 策略控制路由,但这个配置不在 spring.redis 下,而是在 Lettuce 客户端构建时生效。
- 哨兵模式下,只需配置
spring.redis.sentinel.master和spring.redis.sentinel.nodes,然后加一个自定义 Bean: @Bean public LettuceClientConfigurationBuilderCustomizer lettuceCustomizer() { return builder -> builder.readFrom(ReadFrom.REPLICA_PREFERRED); }- 主从模式没有自动哨兵发现能力,得手动构造
RedisMasterSlaveConfiguration,并显式调用setReadFrom(ReadFrom.REPLICA_PREFERRED) -
REPLICA_PREFERRED表示优先读从节点,主节点仅当从节点不可用时才兜底;若强制只读从节点,用REPLICA,但主节点宕机后整个读会失败
别把连接池参数当成负载均衡开关
很多人误以为调大 spring.data.redis.lettuce.pool.max-active 就能让请求“均衡”打到多个节点——这是错的。连接池只管本连接工厂内的连接复用,和节点拓扑无关。
- 集群模式下,一个
RedisConnectionFactory对应全部节点,连接池里的连接会被自动分配到不同槽位所在的节点 - 哨兵或主从模式下,连接池只连当前 master(哨兵会自动刷新地址),读请求是否分流取决于
read-from,不是连接数 - 连接池参数如
max-idle、min-idle只影响本机连接复用效率,跟跨节点流量分布无直接关系
最容易被忽略的一点:集群模式要求所有节点必须已通过 redis-cli --cluster create 正确初始化并处于 ok 状态;哪怕配置全对,只要集群拓扑没建好,Lettuce 连上去也只会反复重定向失败,日志里看不到明显报错,只表现为超时或随机命令失败。


















