解决Redisson中“Unsupported protocol version 34”错误

前言

在使用Redisson客户端连接Redis时,你可能会遇到java.io.IOException: Unsupported protocol version 34这样的异常。这种错误通常与Redisson使用的序列化/反序列化方法(Codec)有关,尤其是在升级或更改Redisson版本后更为常见。

错误详情

以下是从日志中摘录的错误堆栈信息:

复制代码
java.io.IOException: Unsupported protocol version 34 at org.jboss.marshalling.river.RiverUnmarshaller.start(RiverUnmarshaller.java:1375)
...

这个错误提示我们,在尝试解码数据时遇到了不支持的协议版本号34。具体来说,这是由于JBoss Marshalling库在解码过程中无法识别指定版本的数据格式所导致的。

问题原因

此错误的根本原因在于Redisson客户端和服务器之间用于数据传输的编码方式发生了变化。以下是两种主要情况:

  1. 版本兼容性问题:如果你最近从一个旧版本的Redisson升级到新版本(如从3.10.6升至3.18.0),那么默认使用的Codec可能已经从FstCodec变为了MarshallingCodec。这种变更可能导致旧版本写入的数据在新版本中无法被正确读取。
  2. 配置冲突:项目中可能存在部分代码仍然期望使用旧版Codec(如FstCodec),而其他部分则已切换到新的Codec(如MarshallingCodec)。这种情况也会引发上述错误。

解决方案

方案一:调整Codec配置以使用旧版FstCodec

如果需要兼容之前使用FstCodec存储的数据,可以通过添加Maven依赖并注入Redisson配置Bean的方式来解决。

步骤一:导入Maven依赖

首先,在你的pom.xml文件中添加FstCodec相关的依赖:

xml 复制代码
<dependency>
    <groupId>de.ruedigermoeller</groupId>
    <artifactId>fst</artifactId>
    <version>2.57</version>
</dependency>

确保该依赖项被正确引入到你的项目中。

步骤二:配置Redisson使用FstCodec

接下来,你需要配置Redisson使用FstCodec而不是默认的MarshallingCodec。可以通过Spring Boot自动配置的方式实现:

java 复制代码
@Bean
public RedissonAutoConfigurationCustomizer redissonAutoConfigurationCustomizer(){
    return config -> {
        config.setCodec(new FstCodec());
    };
}

这段代码定义了一个Bean,它会自定义Redisson的自动配置,设置其使用的Codec为FstCodec。

方案二:清理数据

如果可以重新初始化你的Redis数据库,清除所有现存的数据并以新格式重新存储它们,这也是解决该问题的一种方法。但是,请注意,这在生产环境中应格外小心,以免造成数据丢失。

方案三:回退或升级版本

根据项目的实际情况,考虑是否有可能回退到之前没有问题的Redisson版本,或者完全迁移到新的版本,并确保整个应用都使用相同的新版Codec。

方案四:更新依赖

确保所有相关的依赖都是最新的,特别是那些与序列化/反序列化相关的库,比如JBoss Marshalling等。

结论

Unsupported protocol version 34错误主要是由于Redisson客户端在处理不同版本之间的Codec兼容性问题引起的。

相关推荐
吃饱了得干活几秒前
从零设计一个高并发点赞系统:缓存+MQ异步持久化实战
java·架构
奇牙coding6 分钟前
gpt-5.6-luna 调用报 400 bad_request 怎么办?同样的 messages 在 gpt-5.5 没问题——两处校验差异和修复写法
java·windows·gpt·ai
sycmancia9 分钟前
Qt——线程的生命期问题
开发语言·qt
影寂ldy10 分钟前
C# 多线程进阶知识点(线程优先级、多委托传参、线程锁、死锁)
开发语言·数据库·c#
国服第二切图仔13 分钟前
09-搜索工具Grep与Glob
开发语言·javascript·ecmascript
凤山老林23 分钟前
从“无法创建本地线程“异常说起:深度解析线程栈与JVM线程优化指南
java·开发语言·jvm
库克克23 分钟前
【C++】多态
开发语言·c++
聚美智数1 小时前
常见疾病查询-疾病症状—疾病介绍-疾病大全-疾病治疗查询API接口介绍
android·java·数据库
慧都小妮子1 小时前
Aspose.Words for JasperReports v26.6 发布,底层Java大升级
java·pdf·报表工具·aspose.words·文档转换·报表导出·jasperreports
白宇横流学长1 小时前
基于SSM医院电子病历管理系统的设计与实现
java