news 2026/4/16 4:35:42

Spring Boot 3.X:Unable to connect to Redis错误记录

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Spring Boot 3.X:Unable to connect to Redis错误记录

一.背景

最近在搭建一个新项目,本着有新用新的原则,项目选择到了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。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/4/8 12:08:17

MDK中STM32调试技巧:超详细版操作指南

MDK中STM32调试实战&#xff1a;从断点到寄存器的深度掌控你有没有遇到过这样的场景&#xff1f;代码写完&#xff0c;下载进STM32板子&#xff0c;结果LED不闪、串口无输出。翻来覆去查了三遍初始化函数&#xff0c;时钟开了&#xff0c;GPIO配了&#xff0c;中断也使能了——…

作者头像 李华
网站建设 2026/4/8 18:24:28

HY-MT1.5-7B部署教程:企业级翻译服务搭建

HY-MT1.5-7B部署教程&#xff1a;企业级翻译服务搭建 随着全球化业务的不断扩展&#xff0c;高质量、低延迟的翻译服务成为企业出海、跨语言协作的核心需求。腾讯开源的混元翻译大模型HY-MT1.5系列&#xff0c;凭借其在多语言支持、翻译质量与部署灵活性上的突出表现&#xff…

作者头像 李华
网站建设 2026/4/9 13:52:40

HY-MT1.5-1.8B边缘计算资源需求分析

HY-MT1.5-1.8B边缘计算资源需求分析 随着多语言交流场景的不断扩展&#xff0c;高质量、低延迟的翻译服务成为智能设备和边缘计算应用的核心需求。腾讯开源的混元翻译模型 1.5 版本&#xff08;HY-MT1.5&#xff09;推出了两个关键模型&#xff1a;HY-MT1.5-1.8B 和 HY-MT1.5-…

作者头像 李华
网站建设 2026/4/13 16:08:22

腾讯HY-MT1.5开源值不值?三大核心优势深度剖析

腾讯HY-MT1.5开源值不值&#xff1f;三大核心优势深度剖析 随着多语言交流需求的持续增长&#xff0c;高质量、低延迟的机器翻译模型成为AI落地的关键基础设施。腾讯近期开源了其混元翻译大模型1.5版本&#xff08;HY-MT1.5&#xff09;&#xff0c;包含两个参数量级的模型&am…

作者头像 李华
网站建设 2026/4/16 4:19:15

HY-MT1.5格式化输出实战:JSON/XML翻译处理

HY-MT1.5格式化输出实战&#xff1a;JSON/XML翻译处理 1. 引言 1.1 背景与业务需求 在多语言全球化应用日益普及的今天&#xff0c;企业级翻译系统不仅需要高精度的语言转换能力&#xff0c;还必须支持结构化数据&#xff08;如 JSON、XML&#xff09;的保留格式翻译。传统翻…

作者头像 李华
网站建设 2026/4/16 4:09:06

AD原理图生成PCB工业控制设计:手把手教程(从零实现)

从一张原理图到工业级PCB&#xff1a;Altium Designer实战全解析你有没有经历过这样的时刻&#xff1f;辛辛苦苦画完原理图&#xff0c;信心满满地点击“Update PCB”&#xff0c;结果弹出一堆错误&#xff1a;“Footprint not found”、“Net not connected”……更糟的是&…

作者头像 李华