Spring Boot配置Redis主从读写分离技巧

Spring Boot 默认不支持 Redis 纯主从架构下的读写分离，即使在配置文件中设置了 `read-from: REPLICA_PREFERRED` 也完全无效——该配置仅在哨兵或集群模式下被自动识别；真正实现读写分离的关键在于让 Lettuce 正确发现主从拓扑（需哨兵自动发现或手动调用 `MasterReplica.connect()`），并配合 `LettuceClientConfigurationBuilderCustomizer` 显式注入 `ReadFrom.REPLICA_PREFERRED` 策略，否则所有读操作（包括 `@Cacheable`）仍将全部打到主节点；验证是否生效不能只看配置是否加载，而必须通过从节点慢日志、`redis-cli monitor` 等手段确认读请求真实路由至副本，否则极易陷入“配了等于没配”的生产陷阱。

Spring Boot 默认的 RedisTemplate 所有操作（包括 get()、@Cacheable）都走主节点，**不开启读写分离**。必须显式配置 Lettuce 的 readFrom 策略，且仅靠 spring.redis.host + port 或逗号拼接多个地址无法触发主从识别——Lettuce 不会自动把它们当主从拓扑处理。

为什么 application.yml 里配了 read-from 却没生效？

常见错误是直接在 spring.redis.lettuce.read-from 下写值，但该配置项只在「哨兵模式」或「集群模式」下被 Spring Boot 自动识别；若你用的是纯主从（非哨兵/非集群），这个配置会被忽略。

• spring.redis.lettuce.read-from: REPLICA_PREFERRED 仅对哨兵（spring.redis.sentinel）或集群（spring.redis.cluster）有效
• 纯主从部署（即只配了 spring.redis.host 和 port）时，Lettuce 默认走 ReadFrom.MASTER，且不解析主从关系
• 即使你在 application.yml 中写了 read-from，日志里也看不到任何 replica 路由行为

如何让 Lettuce 正确识别主从并启用 REPLICA_PREFERRED？

核心是让 Lettuce 通过任意一个节点（哪怕是主节点）发起连接后，主动执行 INFO replication 命令，解析出主节点地址和所有从节点列表。这需要：① 使用哨兵模式，或 ② 手动构造 RedisURI 并调用 MasterReplica.connect()。

• 推荐走哨兵模式：配置 spring.redis.sentinel.master 和 spring.redis.sentinel.nodes，Lettuce 会自动发现主从拓扑，并支持 read-from 配置
• 若坚持不用哨兵，必须自定义 RedisConnectionFactory，用 MasterReplica.connect(…) 构建连接池，不能用默认的 RedisStandaloneConfiguration
• 无论哪种方式，ReadFrom.REPLICA_PREFERRED 必须通过 LettuceClientConfigurationBuilderCustomizer 注入，而不是靠属性绑定

自定义 LettuceClientConfigurationBuilderCustomizer 的正确写法

这是最轻量、兼容 Spring Boot 自动配置的方案。它不替换整个 RedisConnectionFactory，只增强客户端行为：

@Bean
public LettuceClientConfigurationBuilderCustomizer lettuceClientConfigurationBuilderCustomizer() {
    return clientConfigurationBuilder -> 
        clientConfigurationBuilder.readFrom(ReadFrom.REPLICA_PREFERRED);
}

• 该 Bean 必须存在，且不能被 @Primary 冲突覆盖；若已有其他 LettuceClientConfigurationBuilderCustomizer，需合并逻辑
• 它只影响新创建的连接，已建立的连接不会动态切换策略
• 搭配哨兵配置使用才真正生效；纯主从下，因无拓扑发现能力，仍全部路由到主节点

验证读写分离是否真实生效

别只看代码有没有报错，要确认读请求确实发到了从节点。最直接的方式是抓包或查 Redis 日志：

• 在从节点配置中开启慢日志：slowlog-log-slower-than 0，然后执行 redisTemplate.opsForValue().get("key")，检查从节点 slowlog 是否有记录
• 用 redis-cli -p 6380 monitor 监听从节点命令流，观察是否有 GET 进来
• 若始终只有主节点收到读请求，说明 REPLICA_PREFERRED 没起作用——大概率是没走哨兵，或 LettuceClientConfigurationBuilderCustomizer Bean 未被扫描到

真正的读写分离不是“配了就完事”，而是 Lettuce 在每次 sync() 或 async() 调用前，根据当前拓扑实时选择节点。这个动态性意味着：从节点宕机时自动降级读主，新从节点上线后几秒内即可被纳入路由，但前提是拓扑能被正确发现——这点最容易被忽略。

今天关于《Spring Boot配置Redis主从读写分离技巧》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！