解决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兼容性问题引起的。

相关推荐
金銀銅鐵6 小时前
带您看懂字节码指令(二):空循环里有什么
java·后端·ai编程
§ꦿCFོ༉6 小时前
嵌入式八股文—C语言入门学习(四)
c语言·开发语言·学习
投图匠7 小时前
十种不同风格的 CTP接口 框架
开发语言·python
吴名氏.7 小时前
Java转AI Agent教程(第十三周)混合检索与重排
java·数据库·人工智能·ai·ai agent
.痞老板.8 小时前
java ee--多线程(进阶)
java·java-ee
深入云栈10 小时前
Netty 4.2.x 源码深度解析 (二十三):ByteBuf 核心设计 —— 索引、类型与零拷贝
java·后端·架构
爱笑的k1110 小时前
nano-vllm 源码剖析:千行 Python 手写离线推理引擎的调度、显存与并行时序
开发语言·python·vllm
wang_shu_mo_ran11 小时前
MyBatis 从入门到进阶(一)
java·spring·mybatis
X1A0RAN11 小时前
PPT 图片批量处理教程:导出全部幻灯片 · 提取全部素材
开发语言·javascript·powerpoint
量化分析码农12 小时前
股票历史数据的复权参数对照:多级别返回的字段与数值差异
java·javascript·后端