news 2026/5/12 12:03:35

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/5/12 6:22:56

图解说明 error: c9511e:如何正确设置 arm_tool 环境变量

如何绕过error: c9511e&#xff1a;彻底搞懂arm_tool环境变量的正确配置方式你有没有在编译 ARM 项目时&#xff0c;突然遇到一条报错&#xff1a;error: c9511e: unable to determine the current toolkit然后一头雾水&#xff1f;明明代码没动&#xff0c;昨天还能编译通过&a…

作者头像 李华
网站建设 2026/5/9 22:47:42

HY-MT1.5-7B混合语言翻译卡顿?GPU利用率提升实战优化

HY-MT1.5-7B混合语言翻译卡顿&#xff1f;GPU利用率提升实战优化 在多语言交流日益频繁的今天&#xff0c;高质量、低延迟的翻译模型成为智能应用的核心组件。腾讯开源的混元翻译大模型 HY-MT1.5 系列&#xff0c;凭借其对33种主流语言及5种民族语言/方言的支持&#xff0c;迅…

作者头像 李华
网站建设 2026/5/11 12:16:04

腾讯开源HY-MT1.5实战:格式化输出配置详解

腾讯开源HY-MT1.5实战&#xff1a;格式化输出配置详解 随着多语言交流需求的不断增长&#xff0c;高质量、低延迟的翻译模型成为智能应用的核心组件。腾讯近期开源了混元翻译大模型1.5版本&#xff08;HY-MT1.5&#xff09;&#xff0c;涵盖两个关键规模模型&#xff1a;HY-MT…

作者头像 李华
网站建设 2026/5/9 21:30:13

腾讯翻译大模型应用:教育行业多语言课件生成

腾讯翻译大模型应用&#xff1a;教育行业多语言课件生成 在人工智能推动教育数字化转型的背景下&#xff0c;多语言内容的高效生成成为国际化教学的关键需求。腾讯推出的混元翻译大模型 HY-MT1.5 系列&#xff0c;凭借其高精度、低延迟和灵活部署能力&#xff0c;为教育行业提…

作者头像 李华
网站建设 2026/5/9 10:28:57

HY-MT1.5-7B多轮对话:聊天场景上下文保持部署实践

HY-MT1.5-7B多轮对话&#xff1a;聊天场景上下文保持部署实践 1. 引言&#xff1a;从翻译模型到上下文感知的对话系统演进 随着全球化进程加速&#xff0c;跨语言沟通需求激增&#xff0c;传统单句翻译已难以满足真实场景中的复杂交互。腾讯开源的混元翻译模型 HY-MT1.5 系列…

作者头像 李华