Spring Boot 默认不开启 Redis 读写分离，纯主从模式下即使配置 read-from 也无效；必须使用哨兵/集群模式或自定义 MasterReplica.connect()，并配合 LettuceClientConfigurationBuilderCustomizer 注入 ReadFrom.REPLICA_PREFERRED 才能生效。
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没起作用——大概率是没走哨兵，或LettuceClientConfigurationBuilderCustomizerBean 未被扫描到
真正的读写分离不是“配了就完事”，而是 Lettuce 在每次 sync() 或 async() 调用前，根据当前拓扑实时选择节点。这个动态性意味着：从节点宕机时自动降级读主，新从节点上线后几秒内即可被纳入路由，但前提是拓扑能被正确发现——这点最容易被忽略。
