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/15 10:51:06

Keil5使用教程STM32:I2C通信协议时序深度解析

Keil5实战指南&#xff1a;STM32 I2C通信时序深度拆解与调试避坑全记录你有没有遇到过这样的场景&#xff1f;代码写得一丝不苟&#xff0c;接线也按图索骥&#xff0c;可一运行——I2C就是“叫不醒”传感器。SCL有波形&#xff0c;SDA却像死了一样拉不下去&#xff1b;或者明明…

作者头像 李华
网站建设 2026/3/20 18:09:18

HY-MT1.5-1.8B优化:低功耗设备部署技巧

HY-MT1.5-1.8B优化&#xff1a;低功耗设备部署技巧 1. 背景与技术挑战 随着多语言交流需求的快速增长&#xff0c;高质量、低延迟的翻译模型成为智能终端和边缘计算场景的核心组件。腾讯开源的混元翻译大模型 HY-MT1.5 系列&#xff0c;包含 HY-MT1.5-1.8B&#xff08;18亿参…

作者头像 李华
网站建设 2026/4/16 11:54:17

HY-MT1.5-7B模型微调教程:领域自适应实战

HY-MT1.5-7B模型微调教程&#xff1a;领域自适应实战 1. 引言 随着全球化进程的加速&#xff0c;高质量、多语言互译能力已成为自然语言处理&#xff08;NLP&#xff09;领域的核心需求之一。腾讯近期开源了混元翻译大模型系列的最新版本——HY-MT1.5&#xff0c;包含两个主力…

作者头像 李华
网站建设 2026/4/15 12:22:24

CANFD和CAN的区别:STM32控制器模式深度剖析

CANFD与CAN的真正区别&#xff1a;STM32控制器实战解析你有没有遇到过这样的场景&#xff1f;在开发一款基于STM32的ADAS模块时&#xff0c;摄像头每10ms要上传一次目标检测结果。用经典CAN传输&#xff0c;一个完整帧只带8字节数据&#xff0c;而你的目标列表有48字节——这意…

作者头像 李华
网站建设 2026/4/15 12:22:12

Keil C51在电机控制中的应用:实战案例解析

Keil C51在电机控制中的实战密码&#xff1a;从一行代码到风扇智能启停你有没有试过&#xff0c;只用几百字节的代码&#xff0c;让一台直流电机听话地“呼吸”起来&#xff1f;在嵌入式世界里&#xff0c;这并不玄幻。尤其是在那些成本敏感、资源紧张但又必须稳定运行的小型控…

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

Proteus使用教程系统学习:仿真波形观测工具使用

深入掌握Proteus波形观测&#xff1a;从探针到逻辑分析的实战指南你有没有遇到过这样的情况&#xff1f;电路原理图画完了&#xff0c;MCU代码也写好了&#xff0c;仿真一跑&#xff0c;结果却和预期完全不一样——输出电压不对、通信失败、PWM信号乱跳……但又不知道问题出在哪…

作者头像 李华