SpringBoot3.X:Unable to connect to Redis错误及解决方案

 更新时间:2025年12月29日 09:06:04   作者:z***0655  
本文介绍了在Spring Boot 3.4项目中使用Lettuce连接Redis时遇到的问题,通过分析和解决这个问题,作者总结了两种解决方案:手动配置LettuceClientConfiguration.clientOptions的protocolversion和将Lettuce升级到6.5

一.背景

最近在搭建一个新项目,本着有新用新的原则,项目选择到了jdk17+SpringBoot3.4。

但是在测试Redis连接的时候却遇到了以下问题:

redis连不上了。

于是我先去检查了配置文件的连接信息,发现没问题;再去检查配置类:

也没发现问题。

并且我去启动了以前用SpringBoot2.X的老项目,发现同样的配置下,以前的老项目就能成功连上Redis。那这下就大概可以确定原因了:SpringBoot3.4版本下,引用的spring-boot-starter-data-redis可能有点毛病。

二.发现问题

1.问题发现

既然可能是版本问题,那就只能去github上看看了

果然也有其它人遇到了相同的问题,不过还好这个问题已经被解决了

翻译一下就是:

Lettuce驱动程序版本在Spring Data和Spring Boot版本之间发生了变化,这些版本改变了握手行为。我建议您通过clientOptions.builder(). protocolversion (ProtocolVersion.RESP2).build()来配置LettuceClientConfiguration.clientOptions,来强制RESP2处理,这样你就不会遇到HELLO错误,并且将使用AUTH命令来应用身份验证。

看起来Lettuce客户端已经通过redis/ Lettuce #3035修复了6.5版本的问题。

在任何情况下,这都是驱动程序的问题。

据此可以得到两种解决方案:

(1)手动配置LettuceClientConfiguration.clientOptions的protocolversion

(2)将Lettuce升级到6.5

2.问题验证

我的“spring-boot-starter-data-redis”版本是跟着springboot版本走的,也就是3.4.0

接下来看一下“spring-boot-starter-data-redis”提供的lettuce依赖

可以看,到lettuce依赖版本默认是6.4.1,而不是已经解决bug的6.5。接下来对程序debug验证一下lettuce版本为6.4.1时,LettuceClientConfiguration.clientOptions的protocolversion

可以看到,Spring为我们自动配置的RedisConnectionFactory中,clientOptions的protocolVersion属性为null,没有被设置为RESP2。

三.解决方案

1.手动配置LettuceClientConfiguration.clientOptions的protocolversion

我们不使用Spring为我们自动配置的RedisConnectionFactory,而是自己配置一个LettuceConnectionFactory交给IOC容器管理。

在配置LettuceConnectionFactory时通过配置ClientOptions的protocolVersion为RESP2,来解决连接bug。

(1)配置代码

自己配置LettuceConnectionFactory的话还需要引入外部连接池依赖

        <dependency>
			<groupId>org.apache.commons</groupId>
			<artifactId>commons-pool2</artifactId>
		</dependency>

    /**
     * 配置线程池连接工厂LettuceConnectionFactory
     * @return
     */
    @Bean
    public LettuceConnectionFactory lettuceConnectionFactory(){
        // redis配置
        RedisStandaloneConfiguration redisStandaloneConfiguration = new RedisStandaloneConfiguration(host, port);
        redisStandaloneConfiguration.setDatabase(dataBase);
        redisStandaloneConfiguration.setPassword(password);

        // 连接池配置
        GenericObjectPoolConfig genericObjectPoolConfig = new GenericObjectPoolConfig();
        genericObjectPoolConfig.setMinIdle(minIdle);
        genericObjectPoolConfig.setMaxIdle(maxIdle);
        genericObjectPoolConfig.setMaxWait(Duration.ofDays(maxWait));
        genericObjectPoolConfig.setMaxTotal(maxActive);

        // ClientOptions配置
        ClientOptions clientOptions = ClientOptions.builder().protocolVersion(ProtocolVersion.RESP2).build();

        // redis客户端配置
        LettucePoolingClientConfiguration.LettucePoolingClientConfigurationBuilder
                builder =  LettucePoolingClientConfiguration
                .builder()
                .clientOptions(clientOptions)
                .commandTimeout(Duration.ofMillis(timeOut));

        builder.poolConfig(genericObjectPoolConfig);
        LettuceClientConfiguration lettuceClientConfiguration = builder.build();
        return new LettuceConnectionFactory(redisStandaloneConfiguration,lettuceClientConfiguration);
    }

(2)启动验证

可以看到此时注入进来的RedisConnectionFactory就是我们自己配置的LettuceConnectionFactory,其ClientOptions的protocolVersion属性为RESP2。Redis可以被正常连接。

2.将Lettuce升级到6.5

这种方法就比较简单粗暴了,既然“spring-boot-starter-data-redis”提供的lettuce依赖版本为6.4,那我们就不用它提供的了,自己引入版本为6.5的lettuce依赖。

(1)配置代码

        <!--redis-->
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-data-redis</artifactId>
			<exclusions>
				<exclusion>
					<groupId>io.lettuce</groupId>
					<artifactId>lettuce-core</artifactId>
				</exclusion>
			</exclusions>
		</dependency>
		<!--lettuce-->
		<dependency>
			<groupId>io.lettuce</groupId>
			<artifactId>lettuce-core</artifactId>
			<version>${lettuce.version}</version>
		</dependency>
		<!--外部连接池-->
		<dependency>
			<groupId>org.apache.commons</groupId>
			<artifactId>commons-pool2</artifactId>
		</dependency>

其中lettuce.version是6.5.0.RELEASE。最下面的“commons-pool2”是如果要自己配置LettuceConnectionFactory才需要引入,也就是方案一要用到,这里没有删掉。

(2)启动验证

IOC容器中的Spring为我们自动配置的RedisConnectionFactory的clientOptions.protocolVersion仍然是null,但是此时Redis已经可以正常连接上了,说明Lettuce 6.5.0已经解决了认证连接bug。

总结

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。

相关文章

  • 浅谈Mybatis之参数传递的几种姿势

    浅谈Mybatis之参数传递的几种姿势

    在mybatis的日常开发中,mapper接口中定义的参数如何与xml中的参数进行映射呢?本文就详细的介绍一下,感兴趣的可以了解一下
    2021-09-09
  • Spring 依赖注入实现示例

    Spring 依赖注入实现示例

    这篇文章主要介绍了Spring 依赖注入实现示例的相关资料,帮助大家更好的理解和使用spring框架,感兴趣的朋友可以了解下
    2020-11-11
  • Retrofit+Rxjava下载文件进度的实现

    Retrofit+Rxjava下载文件进度的实现

    这篇文章主要介绍了Retrofit+Rxjava下载文件进度的实现,非常不错,具有参考借鉴价值,需要的朋友可以参考下
    2017-11-11
  • Java深度优先遍历解决排列组合问题详解

    Java深度优先遍历解决排列组合问题详解

    这篇文章主要介绍了Java深度优先遍历解决排列组合问题详解,深度优先搜索是递归过程,带有回退操作,因此需要使用栈存储访问的路径信息,当访问到的当前顶点没有可以前进的邻接顶点时,需要进行出栈操作,将当前位置回退至出栈元素位置,需要的朋友可以参考下
    2024-01-01
  • java中double强制转换int引发的OOM问题记录

    java中double强制转换int引发的OOM问题记录

    这篇文章主要介绍了java中double强制转换int引发的OOM问题记录,本文给大家分享问题排查过程,感兴趣的朋友跟随小编一起看看吧
    2024-10-10
  • selenium+java+chrome环境搭建的方法步骤

    selenium+java+chrome环境搭建的方法步骤

    这篇文章主要介绍了selenium+java+chrome环境搭建的方法步骤,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-07-07
  • Java毕业设计实战之药店信息管理系统的实现

    Java毕业设计实战之药店信息管理系统的实现

    这是一个使用了java+SSM+JSP+layui+maven+mysql开发的药店信息管理系统,是一个毕业设计的实战练习,具有药店信息管理该有的所有功能,感兴趣的朋友快来看看吧
    2022-01-01
  • SpringMVC上传和解析Excel方法

    SpringMVC上传和解析Excel方法

    这篇文章主要介绍了SpringMVC上传和解析Excel方法,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2016-12-12
  • java开发分布式服务框架Dubbo调用过程

    java开发分布式服务框架Dubbo调用过程

    这篇文章主要为大家介绍了java开发分布式服务框架Dubbo调用过程,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步早日升职加薪
    2021-11-11
  • Spring-Boot 访问外部接口的方案总结

    Spring-Boot 访问外部接口的方案总结

    在Spring-Boot项目开发中,存在着本模块的代码需要访问外面模块接口,或外部url链接的需求,针对这一需求目前存在着三种解决方案,下面将对这三种方案进行整理和说明,对Spring-Boot 访问外部接口方案感兴趣的朋友跟随小编一起看看吧
    2022-12-12

最新评论