news 2026/4/3 1:28:59

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/3/28 3:18:11

翻译模型性能优化:HY-MT1.5参数调优详解

翻译模型性能优化&#xff1a;HY-MT1.5参数调优详解 1. 引言&#xff1a;腾讯开源的高性能翻译模型 HY-MT1.5 随着全球化进程加速&#xff0c;高质量、低延迟的机器翻译需求日益增长。传统翻译服务在多语言支持、上下文理解与实时性方面面临挑战&#xff0c;尤其在边缘计算和混…

作者头像 李华
网站建设 2026/4/1 19:54:26

腾讯开源翻译模型HY-MT1.5:从零开始部署教程

腾讯开源翻译模型HY-MT1.5&#xff1a;从零开始部署教程 1. 引言 随着全球化进程的加速&#xff0c;高质量、低延迟的机器翻译需求日益增长。腾讯近期开源了其最新的混元翻译大模型 HY-MT1.5 系列&#xff0c;包含两个版本&#xff1a;HY-MT1.5-1.8B 和 HY-MT1.5-7B&#xff0…

作者头像 李华
网站建设 2026/3/9 14:33:02

混元翻译1.5上下文缓存机制:长文档处理优化

混元翻译1.5上下文缓存机制&#xff1a;长文档处理优化 1. 引言&#xff1a;混元翻译模型的演进与挑战 随着全球化进程加速&#xff0c;高质量、多语言互译需求日益增长。传统翻译模型在处理短句时表现优异&#xff0c;但在面对长文档、跨段落语义连贯性要求高的场景时&#…

作者头像 李华
网站建设 2026/3/21 14:44:47

HY-MT1.5-7B模型并行推理:分布式部署方案

HY-MT1.5-7B模型并行推理&#xff1a;分布式部署方案 1. 引言 随着多语言交流需求的不断增长&#xff0c;高质量、低延迟的机器翻译系统成为智能应用的核心组件。腾讯开源的混元翻译大模型 HY-MT1.5 系列&#xff0c;包含 HY-MT1.5-1.8B 和 HY-MT1.5-7B 两个版本&#xff0c;…

作者头像 李华
网站建设 2026/3/21 6:04:53

STM32CubeMX安装包Linux平台配置从零实现

从零搭建STM32CubeMX Linux开发环境&#xff1a;不只是安装&#xff0c;更是工程思维的落地你有没有遇到过这样的场景&#xff1f;刚换到Linux系统&#xff0c;信心满满地准备开启高效嵌入式开发之旅&#xff0c;结果一打开终端想启动STM32CubeMX——界面闪退、Java报错、ST-LI…

作者头像 李华
网站建设 2026/3/22 17:11:53

STLink驱动下载在工控系统中的项目应用

STLink驱动下载在工控系统中的实战应用&#xff1a;从烧录失败到批量部署的全链路解析 你有没有遇到过这样的场景&#xff1f; 凌晨两点&#xff0c;产线即将交付最后一批控制器&#xff0c;自动化烧录脚本却突然卡住——“Failed to connect to target”。一群人围着几块开发…

作者头像 李华