redis 反序列化deserialize异常问题解决

最新推荐文章于 2025-10-31 00:01:46 发布
原创 最新推荐文章于 2025-10-31 00:01:46 发布 · 1.2w 阅读 · 2 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#serializer #反序列化异常

本文详细解析了在使用Spring Boot整合Redis时，出现的序列化与反序列化异常问题。主要原因是不同系统间共享Redis资源，导致对象序列化路径不匹配引发的ClassNotFound异常。文章提供了具体的解决方案，即清理Redis缓存，确保对象序列化路径的一致性。

异常信息

 

ERROR org.apache.catalina.core.ContainerBase.[Tomcat].[localhost].[/].[dispatcherServlet] - Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed; nested exception is org.springframework.data.redis.serializer.SerializationException: Cannot deserialize; nested exception is org.springframework.core.serializer.support.SerializationFailedException: Failed to deserialize payload. Is the byte array a result of corresponding serialization for DefaultDeserializer?; nested exception is org.springframework.core.NestedIOException: Failed to deserialize object type; nested exception is java.lang.ClassNotFoundException: com.xxx.tpam.dao.model.Dict] with root cause

java.lang.ClassNotFoundException: com.xxx.tpam.dao.model.Dict

分析：这个错误提示找不到类，反序列化的时候报错，而对象系列化时是跟对象所处的包路径相关的。

 

我本地测试，几个系统用的同一个redis，对象在一个系统中序列化存入redis，包路径com.xxx.tpam.dao.model.Dict；主要原因是因为key也是相同，在运行另一个系统时，发现这个key已经存在了，取出时，因当前这个系统包路径为com.xxx.book.dao.model.Dict，由于两个对象的类所处的包路径不一致，反序列化失败，因而报找不到类错误。

解决方法：

直接删除redis中对应的值即可

我是使用的本地库，就直接在redis-cli 执行了flushall（删除所有数据库中的所有key ） 命令

 

 

【项目实战】Redis的序列化与反序列化
奶爸的编程之路，也就一周冷个三天，欢迎关注我的微信公众号：本本本添哥
04-18 2619
在Redis中，数据可以被序列化为二进制格式并存储在内存中，以提高读写性能。 Redis支持多种序列化格式，包括JSON、MessagePack和Protocol Buffers。 默认情况下，Redis使用自己的二进制序列化格式，但可以通过配置文件更改为其他格式。
HSF 调用异常
weixin_40769819的博客
09-24 7124
异常： HSF deserialization response failed on client side. If the Biz DO type is not fully compatible with hessian, service provider can change serialize type to "java" on HSFSpringProviderBean.com.dbxi...
Rust 中的 Serialize 与 Deserialize：数据序列化的艺术与实践
最新发布
m0_63963847的博客
10-31 581
Rust 的Serialize和trait 代表了如何在保持类型安全的前提下，构建高性能、可扩展的数据交互层。掌握这些 trait 的不仅是使用 serde 的技巧，更是理解 Rust 如何通过 trait 系统实现零成本抽象的窗口。深度的应用需要你思考：数据版本演进、错误处理策略、性能优化空间，以及在不同场景下的权衡选择。
Springboot+ Redis Could not get a resource since the pool is exhausted] with root cause
backer
07-10 2887
问题描述： SpringBoot + 虚拟机redis context with path [] threw exception [Request processing failed; nested exception is redis.clients.jedis.exceptions.JedisExhaustedPoolException: Could not get a resource since the pool is exhausted] with root cause java.util.
记录解决idea的修改包名后导致redis反序列化deserialize异常问题（Failed to deserialize payload）
m0_69722896的博客
12-26 1096
解决redis反序列化失败
redis 反序列化异常问题
weixin_42620858的博客
03-07 1943
项目场景： 项目场景：账户用户列表页加载失败，前后端分离，后端调用接口能正常返回数据，但是前端不展示，让同事跟新代码却能正常显示 问题描述： 报错内容：{“success”:false,“message”:"Cannot deserialize; nested exception is org.springframework.core.serializer.support.SerializationFailedException: Failed to deserialize payload. Is the
SpringBoot Redis配置Fastjson进行序列化和反序列化实现
10-16
在处理Java对象与Redis之间的转换时，序列化和反序列化是必不可少的步骤。本篇将详细介绍如何在Spring Boot中配置Fastjson进行序列化和反序列化，以实现与Redis的高效交互。 Fastjson是阿里巴巴开发的一款高性能的...
shiro的session信息放redis反序列化异常解决
weixin_48352162的博客
06-26 1647
背景 在本地session移至redis存储时，原本以为引入spring-session-data-redis依赖，配置RedisHttpSessionConfiguration，在web.xml中引入springSessionRepositoryFilter就结束了，没想到遇到序列化相关的问题，具体就是只有getter，没有setter。日志如下： 26-Jun-2021 15:53:16.432 涓ラ噸 [http-nio-8081-exec-6] org.apache.catalina.core.St
多项目共用redis导致反序列化出错：Failed to deserialize object type； nested exception is java.lang.ClassNotFoundExc
xhuiting的博客
04-12 2376
解决多项目共用一个redis，若存在相同的key时，会被覆盖，导致反序列化获取该key时，存在找不到该类的情况。
RedisTemplate序列化反序列化失败Cannot deserialize
08-31 4910
@Configuration public class RedisConfig { @Bean public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory redisConnectionFactory) { RedisTemplate<String, Object> redisTemplate = new RedisTemplate<>(...
idea的修改包名后导致redis反序列化deserialize异常问题
qq_29127369的博客
07-18 1536
今天上午在网上下载了一个项目，打算在这个项目进行开发，但是项目的包名和要做的项目名称不一样，就想着自己新建一个项目，把里面的类都移植过去。 中间碰到各种问题，这里主要是记录一下redis反序列化deserialize异常问题。 项目在启动时没有问题，但是等到登入系统的时候却抛出 com.alibaba.fastjson.JSONException: autoType is not support....
Redis | 使用redis存储对象反序列化异常SerializationFailedException
热门推荐
Eshare分享
05-03 1万+
案例 使用Redis进行对象存储，在处理业务逻辑的时候，丛Redis获取对象发现反序列化失败，抛出如下异常: Caused by: org.springframework.data.redis.serializer.SerializationException: Cannot deserialize; nested exception is org.springframework.core...
redis反序列化报错原因分析和解决方案
weixin_41650051的博客
05-28 5372
问题：Cannot deserialize，无法反序列化 分析： 一、序列化id’不一致 1、实体类实现了序列化接口后，没有指定序列化id。 2、srpingboot jar包版本不一致的两个class文件，序列化id不一致。 二、实体类属性不一致 1、可能存到redis的时候是两个属性，但是我们本地业务扩展，新增了一些字段，也是无法完成饭序列的。 解决方案： 1、指定序列化id 2、统一jar报版本 3、清除redis库 ...
redis Cannot deserialize
yuhui666666的博客
11-22 1522
redis Cannot deserialize     由于自己序列化了一次，然后redis中又配置了序列化的类，所以获取的时候编码不对，错误,这时不需要自己特意去实例化类后保存，直接用配置好的即可     &lt;bean id="redisTemplate" class="org.springframework.data.redis.core.StringRedisTempla...
Redis序列化和反序列化失败： org.springframework.data.redis.serializer.SerializationExceptionng
qq_47932288的博客
11-30 2963
redis序列化和反序列化失败，因为RedisTemplate默认的序列化方式是用org.springframework.data.redis.serializer.JdkSerializationRedisSerializer这个类来做序列化，而Redis有自己的序列化方式，所以冲突了报出了上面的序列化异常的信息。设置redis key和value的序列化器，采用自定义的序列化器，就可以正常的插入序列化后的值和将缓存的值反序列化为java对象。
SpringBoot整合Redis过程中报错：Cannot deserialize； nested exception is org.springframework.core.serializer
ifhuke的博客
10-22 5716
springboot整合缓存时报错
微服务分布式缓存：无法反序列化 Cannot deserialize；
jhin_lx的博客
04-17 872
什么是序列化-什么是反序列化。
redis反序列化失败原因
04-03
### Redis 反序列化失败的原因 Redis 反序列化失败通常发生在尝试从 Redis 中读取数据并将其转换为 Java 对象的过程中。以下是可能导致此问题的主要原因及其对应的解决方案： #### 1. **序列化 ID 不匹配** 当实体类实现 `Serializable` 接口时，如果没有显式定义 `serialVersionUID` 或者不同版本的类具有不同的 `serialVersionUID`，则可能会导致反序列化失败[^3]。 - **解决方案**: 确保所有涉及序列化的类都明确定义了唯一的 `serialVersionUID`，并且在多个系统之间保持一致性。 ```java private static final long serialVersionUID = 1L; ``` --- #### 2. **类结构发生变化** 如果存储到 Redis 的对象与其当前加载的类结构不一致（例如新增或删除字段），也会引发反序列化错误。 - **解决方案**: 清理旧的缓存数据或将新字段标记为可选（如使用 Jackson 注解）。对于已存在的数据，可以考虑兼容处理逻辑。 ```java @JsonInclude(JsonInclude.Include.NON_NULL) public class Example { private String field1; @JsonProperty("newField") // 新增字段兼容处理 private String optionalField; } ``` --- #### 3. **使用的序列化器不匹配** 默认情况下，Spring 使用 JdkSerializationRedisSerializer 进行序列化/反序列化操作。然而，这种序列化方式会产生不可读的字节数组，并且容易与其他工具冲突。如果切换至其他序列化器（如 Jackson），未正确配置也可能导致反序列化失败[^2]。 - **解决方案**: 统一使用相同的序列化器。推荐采用更高效的 JSON 序列化器（如 Jackson）替代 JDK 默认序列化器。 ```java @Configuration public class RedisConfig { @Bean public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory connectionFactory) { RedisTemplate<String, Object> template = new RedisTemplate<>(); template.setConnectionFactory(connectionFactory); // 设置键和值的序列化器 GenericJackson2JsonRedisSerializer serializer = new GenericJackson2JsonRedisSerializer(); template.setDefaultSerializer(serializer); return template; } } ``` --- #### 4. **Redis 数据被篡改或损坏** 如果 Redis 存储的数据被意外修改或者由于网络传输等原因发生损坏，则会导致反序列化失败[^1]。 - **解决方案**: 验证 Redis 数据的一致性和完整性。可以通过定期备份 Redis 数据以及设置合理的过期时间来减少此类风险。 --- #### 5. **依赖库版本差异** 不同 Spring Boot 版本之间的序列化机制可能存在细微差别，尤其是在升级过程中引入的新特性或修复补丁会影响现有行为。 - **解决方案**: 确保所有参与系统的 Spring Boot 和相关依赖版本完全一致。必要时查阅官方文档确认是否存在已知问题。 --- ### 总结 Redis 反序列化失败的根本原因是序列化与反序列化过程中的不一致性。通过明确 `serialVersionUID`、维护稳定的类结构、选用合适的序列化器以及保障环境一致性等方式能够有效解决问题。 ```python # 示例代码展示如何自定义 Redis 配置以避免反序列化异常 from redis import Redis import json def serialize(obj): """ 将 Python 对象序列化为 JSON 字符串 """ return json.dumps(obj) def deserialize(data): """ 将 JSON 字符串反序列化为 Python 对象 """ try: return json.loads(data) except Exception as e: raise ValueError(f"Deserialization failed: {e}") # 初始化 Redis 客户端 client = Redis(host='localhost', port=6379, db=0) key = 'example_key' value = {'name': 'Alice', 'age': 25} # 存储前先序列化 serialized_value = serialize(value) client.set(key, serialized_value) # 获取后立即反序列化 stored_data = client.get(key).decode('utf-8') deserialized_value = deserialize(stored_data) print(deserialized_value) ```
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值