Spring Boot 3.3升级后本地Redis正常，生产环境Redis连接失败求助

核心问题 #

Spring Boot从2.7.18升级到3.3后，本地通过端口转发测试Redis正常，但生产环境抛出RedisConnectionFailureException，核心是生产环境的Redis连接链路或配置与本地存在差异，且Spring 3.x对Redis客户端的默认配置做了调整。

排查方向及解决方法 #

• Lettuce客户端默认配置变更
  Spring 3.3配套的spring-data-redis 3.3升级了Lettuce版本，默认启用了异步共享连接模式，部分生产Redis实例可能不兼容。

  • 显式关闭异步模式：在配置文件中添加spring.data.redis.lettuce.async=false
  • 检查spring.data.redis.lettuce.shutdown-timeout，3.x默认从100ms改为1000ms，若生产网络延迟高，可适当调大

• 生产环境网络与安全校验
  本地端口转发绕过了生产网络策略，必须确认：

  • 在生产服务器上执行telnet redis-host redis-port或nc -zv redis-host redis-port，测试是否能连通Redis实例
  • 核对spring.data.redis.password配置，3.x中密码若含特殊字符需URL编码，确保和Redis实例的认证密码一致
  • 检查Redis配置的bind项是否限制了生产服务器IP，或是否开启了protected-mode导致拒绝外部连接

• Redis连接池配置差异
  Spring 3.x调整了连接池默认参数，可能导致生产环境连接池耗尽：

  • 显式指定连接池参数，统一本地和生产配置：

    spring.data.redis.lettuce.pool.max-active=8
    spring.data.redis.lettuce.pool.max-idle=8
    spring.data.redis.lettuce.pool.min-idle=0
    spring.data.redis.lettuce.pool.max-wait=-1ms
    

  • 查看生产环境日志，是否有连接池获取超时的相关记录，必要时调大max-active值

• Reactor环境依赖冲突
  报错中出现Reactor相关异常，说明使用了异步Redis操作：

  • 检查项目依赖树，确保reactor-core版本统一（Spring 3.3对应Reactor 3.5+），避免版本冲突
  • 尝试将异步Redis操作改为同步模式，或添加spring.data.redis.lettuce.client-name=your-app-name配置，方便Redis端排查连接来源

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