SpringBoot中LettuceConnectionFactory未按配置连远程Redis仍连localhost

以下是几个可能导致该问题的排查方向：

• 配置文件加载优先级冲突
  检查是否存在多配置源覆盖了目标Redis地址：

  • 确认启动参数、环境变量、系统属性中是否设置了spring.data.redis.host=localhost这类强制覆盖的配置；
  • 核对配置文件属性前缀是否正确：部分Spring Boot版本使用spring.redis.*而非spring.data.redis.*作为Redis配置前缀，若属性写错会导致自动配置回退到localhost默认值；
  • 查看启动日志中spring.data.redis.host的实际加载值，确认是否为预期的AWS Redis地址。

• Bean优先级问题

  • 检查项目中是否存在其他@Configuration类定义了ReactiveRedisConnectionFactory或RedisConnectionFactory，且通过@Primary注解抢占了优先级；
  • 可以在自定义的reactiveRedisConnectionFactory方法上添加@Primary注解，确保它被Spring容器优先选用。

• 配置属性注入验证
  在自定义ReactiveRedisConnectionFactory的方法中添加日志或打印语句，验证@Value注入的host和port是否为正确的AWS Redis地址：

  @Bean
  public ReactiveRedisConnectionFactory reactiveRedisConnectionFactory() {
      System.out.println("Loaded Redis Host: " + host + ", Port: " + port); // 临时验证用
      // 原有代码...
  }
  

  如果输出是localhost，说明属性注入环节就出了问题，需要排查配置文件是否被正确加载。

• 自动配置逻辑冲突
  当移除自定义ReactiveRedisConnectionFactory依赖自动配置时，依然连接localhost，说明自动配置没有读取到正确的属性：

  • 检查application.properties/yml中是否存在拼写错误，比如spring.data.redis.host写成spring.data.redis.hosts；
  • 开启Spring Boot的debug模式，查看自动配置日志，确认LettuceConnectionFactoryAutoConfiguration是否正确读取了配置属性并初始化连接工厂。

• 依赖版本不一致
  对比故障服务和正常服务的依赖版本：

  • 检查Spring Boot、Spring Data Redis、Lettuce的版本是否完全一致；
  • 部分旧版本可能存在配置逻辑差异，比如对SSL配置的处理、属性绑定规则不同，导致连接参数未生效。

• 环境层面的配置覆盖

  • 本地开发时，检查IDE的运行配置中是否添加了spring.data.redis.host的启动参数；
  • 开发服务器上，排查是否存在系统环境变量SPRING_DATA_REDIS_HOST覆盖了配置文件的值。

内容的提问来源于stack exchange，提问作者LeperAffinity666