讲师中心 微信公众号
AI工具推荐 视频效率加速

如何解决Spring Boot集成Redis时的类转换异常_设置Jackson2JsonRedisSerializer的反序列化类型

梦明酱_6260

梦明酱_6260

发布时间:2026-06-09 06:59:19

|

908人浏览过

|

来源于php中文网

原创

根本原因是Jackson反序列化时缺乏类型信息,只能退化为LinkedHashMap;必须通过GenericJackson2JsonRedisSerializer配合启用DefaultTyping的ObjectMapper,或使用Jackson2JsonRedisSerializer<User>指定具体类型,才能正确还原实体类。

如何解决spring boot集成redis时的类转换异常_设置jackson2jsonredisserializer的反序列化类型

直接结论:不是序列化器选错了,而是反序列化时 Jackson 不知道该还原成哪个类——必须显式告诉它,否则默认就给你塞个 LinkedHashMap。

为什么取出来总是 LinkedHashMap 而不是你的实体类?

这是最典型的表象错误。根本原因在于 Jackson2JsonRedisSerializer(或 GenericJackson2JsonRedisSerializer)在反序列化 JSON 字符串时,没拿到类型信息,只能退化为通用容器。它不“猜”你存的是 User 还是 Order,除非你提前注册好。

  • 用 new Jackson2JsonRedisSerializer(Object.class) 初始化,等于把反序列化入口设成了最宽泛的 Object,Jackson 只能按 JSON 结构映射成 LinkedHashMap
  • 如果存的是 Map 类型(比如 HashMap),取出来变成 LinkedHashMap 是正常行为——因为 Jackson 默认只保证接口语义,不保留具体实现类
  • 真正要报 ClassCastException,往往是业务代码写了 (User) redisTemplate.opsForValue().get("key"),而实际返回的是 LinkedHashMap

Jackson2JsonRedisSerializer 和 GenericJackson2JsonRedisSerializer 怎么选?

别被名字误导:GenericJackson2JsonRedisSerializer 才是带类型提示能力的那个;Jackson2JsonRedisSerializer 是“纯 JSON”模式,不写 @class 字段,也不读类型信息。

Spring Boot Actuator Analyzer
Spring Boot Actuator Analyzer

分析Spring Boot Actuator端点的安全性、健康检查、指标暴露及生产配置——审计信息、健康状态和自定义端点。

下载
  • Jackson2JsonRedisSerializer<T>:适合存固定类型,比如只存 User,就初始化为 new Jackson2JsonRedisSerializer<>(User.class);但不能混存多种类型
  • GenericJackson2JsonRedisSerializer:支持多态,会自动在 JSON 里加 @class 字段(如 {"@class":"com.example.User","name":"zhang"}),但必须配好 ObjectMapper 白名单,否则抛 InvalidTypeIdException
  • Spring Boot 2.6+ 默认禁用 DEFAULT_TYPING,老项目升级后,原来能跑的 GenericJackson2JsonRedisSerializer 会突然报错

怎么配一个安全又可用的 ObjectMapper?

核心就两条:关掉危险的全局白名单,只注册你真正在用的类或包。

  • 不要用 mapper.enableDefaultTyping(ObjectMapper.DefaultTyping.NON_FINAL) —— 这等价于开 ALLOW_ALL,有反序列化 RCE 风险
  • 推荐注册整个包:mapper.registerSubtypes(PackageVersion.create("com.example.dto", null)),再配合 mapper.activateDefaultTyping(..., JsonTypeInfo.As.PROPERTY, JsonTypeInfo.Id.CLASS)
  • 如果只用几个类,更安全:mapper.registerSubtypes(new NamedType(User.class, "User"), new NamedType(Order.class, "Order"))
  • Lombok 实体类必须有 @NoArgsConstructor,否则 Jackson 构造失败也会表现为类型转换异常

为什么改了 RedisTemplate 还是报错?

常见疏漏点:你可能只改了 RedisTemplate<String, Object>,但业务里实际用的是 StringRedisTemplate 或缓存注解(@Cacheable)背后的默认模板。

  • StringRedisTemplate 是独立 Bean,它的 value 序列化器默认是 StringRedisSerializer,不走你配的 GenericJackson2JsonRedisSerializer,存对象会直接失败
  • @Cacheable 默认使用 cacheManager 绑定的 RedisCacheConfiguration,需单独配置 RedisCacheConfiguration.serializeValuesWith(...)
  • 确认生效方式:打个断点进 GenericJackson2JsonRedisSerializer.deserialize(),看是否真被调用;或者用 redis-cli --raw get key 看 Redis 里存的到底是不是带 @class 的 JSON

最易被忽略的一点:类型信息只在序列化时写入、反序列化时读取。如果你的 key 是手动用 redis-cli set 写进去的纯 JSON(没 @class),哪怕配得再完美,反序列化也必然失败——Jackson 没法无中生有猜类型。

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

LibLibAI
LibLibAI Hot

一款AI视频创作工具,主要用于国内领先的AI创意平台,以海量模型、低门槛操作与“创作-分享-商业化”生态,让小白与专业创作者都能高效实现图文乃至视频创意表达,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

2411

2025.08.06

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

437

2026.01.26

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

4096

2023.06.20

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1275

2023.07.28

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1658

2023.08.03

js是什么意思
js是什么意思

JS是JavaScript的缩写,它是一种广泛应用于网页开发的脚本语言。JavaScript是一种解释性的、基于对象和事件驱动的编程语言,通常用于为网页增加交互性和动态性。它可以在网页上实现复杂的功能和效果,如表单验证、页面元素操作、动画效果、数据交互等。

9623

2023.08.17

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

920

2023.09.01

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2464

2023.09.04

C++运算符基础入门
C++运算符基础入门

本专题详细讲解了C++运算符的类型、语法与使用方法,涵盖算术运算符、关系运算符、逻辑运算符、位运算符、赋值运算符、条件运算符及其他特殊运算符,并通过代码示例解析优先级与结合性。

0

2026.10.09

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn