如何在Spring Boot 3中正确配置RedisTemplate序列化方式

陌伟吖_6636

陌伟吖_6636

2026-10-12

726人浏览

原创

默认使用jdkserializationredisserializer会导致redis cli显示乱码(如\xac\xed\x00\x05)且跨语言不可读,反序列化返回linkedhashmap而非原类型;必须改用jackson2jsonredisserializer并显式指定泛型类型(如get("key", user.class)),同时配置objectmapper禁用fail_on_empty_beans、注册javatimemodule、设置setusedefaultmapper(false)。

如何在spring boot 3中正确配置redistemplate序列化方式

默认用 JdkSerializationRedisSerializer 存对象,Redis CLI 里全是 \xac\xed\x00\x05,Java 外其他语言根本读不了;更糟的是,反序列化回来是 LinkedHashMap,不是你的 User 类——这不是配置漏了,是默认压根没打算让你“看”或“跨语言互通”。

为什么 RedisTemplate 默认序列化会导致乱码和类型丢失

JdkSerializationRedisSerializer 把对象转成 Java 原生二进制流,结果:

  • Redis CLI、RedisInsight 等工具显示为空或乱码(\xac\xed\x00\x05...)
  • 其他语言(如 Node.js、Python)无法解析,因为不兼容 JDK 序列化协议
  • 如果类没实现 Serializable,运行时报 NotSerializableException
  • 调用 redisTemplate.opsForValue().get("key") 返回 Object,实际是 LinkedHashMap,强转 User.class 直接 ClassCastException

必须用 Jackson2JsonRedisSerializer 并显式传类型参数

换 JSON 序列化只是第一步,关键在反序列化时必须告诉 Jackson “你要还原成什么类”,否则它只能猜成 LinkedHashMap。

  • 用 Jackson2JsonRedisSerializer<object></object> 初始化 value 序列化器,但不能只传 Object.class
  • 存的时候没问题:redisTemplate.opsForValue().set("user:1", user)
  • 取的时候必须指定类型:redisTemplate.opsForValue().get("user:1", User.class),不能只写 get("user:1")
  • 否则返回的 Object 是 LinkedHashMap,不是 User

自定义 ObjectMapper 时三个关键设置不能少

光换序列化器还不够,Jackson 默认行为会卡住你:

Spring Boot Actuator Analyzer
Spring Boot Actuator Analyzer

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

下载
  • 必须调 setUseDefaultMapper(false),否则你配的 ObjectMapper 被忽略
  • 必须禁用 SerializationFeature.FAIL_ON_EMPTY_BEANS,否则 Lombok 生成的无参类(比如只有 @Data)反序列化失败
  • 时间类型要统一处理:加 JavaTimeModule,否则 LocalDateTime 存进去变字符串、取出来是 Map 或报错

示例片段:

@Bean
public RedisTemplate<string object> redisTemplate(RedisConnectionFactory connectionFactory) {
    RedisTemplate<string object> template = new RedisTemplate();
    template.setConnectionFactory(connectionFactory);
    template.setKeySerializer(new StringRedisSerializer());
    
    Jackson2JsonRedisSerializer<object> serializer = new Jackson2JsonRedisSerializer(Object.class);
    ObjectMapper mapper = new ObjectMapper();
    mapper.registerModule(new JavaTimeModule());
    mapper.disable(SerializationFeature.FAIL_ON_EMPTY_BEANS);
    serializer.setObjectMapper(mapper);
    template.setValueSerializer(serializer);
    template.setHashValueSerializer(serializer);
    template.setUseDefaultMapper(false); // 这行不能漏
    
    template.afterPropertiesSet();
    return template;
}</object></string></string>

别用 StringRedisTemplate 曲线救国

有人图省事改用 StringRedisTemplate,手动 json.writeValueAsString() 再存,看似能读——但代价是:

  • 丢了类型安全:取出来永远是 String,得自己 readValue(..., User.class)
  • 没法直接操作泛型集合(比如 SetOperations<string user></string>)
  • 缓存穿透/空值场景下,JSON 字符串和 null 边界容易混淆
  • 和 @Cacheable 集成时,类型擦除问题更难调试

真正麻烦的不是“怎么配”,而是反序列化那一句 get("key", User.class) 容易被忽略——它不像编译期报错,而是在运行时某次取值突然崩掉,而且崩得毫无征兆。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

redis spring boot

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

2025.08.06

2451

22

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

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

2026.01.26

457

25

常用的数据库软件
常用的数据库软件

常用的数据库软件有MySQL、Oracle、SQL Server、PostgreSQL、MongoDB、Redis、Cassandra、Hadoop、Spark和Amazon DynamoDB。更多关于数据库软件的内容详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.02

4409

19

内存数据库有哪些
内存数据库有哪些

内存数据库有Redis、Memcached、Apache Ignite、VoltDB、TimesTen、H2 Database、Aerospike、Oracle TimesTen In-Memory Database、SAP HANA和ache Cassandra。更多关于内存数据库相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.14

3935

11

mongodb和redis哪个读取速度快
mongodb和redis哪个读取速度快

redis 的读取速度比 mongodb 更快。原因包括:1. redis 使用简单的键值存储,而 mongodb 存储 json 格式的数据,需要解析和反序列化。2. redis 使用哈希表快速查找数据,而 mongodb 使用 b-tree 索引。因此,redis 在需要高性能读取操作的应用程序中是一个更好的选择。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.02

7192

6

redis怎么做缓存服务器
redis怎么做缓存服务器

redis 作为缓存服务器的答案:redis 是一款开源、高性能、分布式的键值存储,可作为缓存服务器使用。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.07

643

6

redis怎么解决数据一致性
redis怎么解决数据一致性

redis 提供了两种一致性模型,以维护副本数据一致性:强一致性 (sync) 确保写操作仅在复制到所有从节点后才完成;最终一致性 (async) 则在主节点上写操作后认为已完成,牺牲一致性换取性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.07

756

6

mysql和redis怎么保证双写一致性
mysql和redis怎么保证双写一致性

确保 mysql 和 redis 双写一致性的技术包括:1、事务性更新:同时更新 mysql 和 redis,保证一致性;2、主从复制:mysql 主服务器更改同步到 redis 从服务器;3、基于事件的更新:mysql 记录更改并发送到 redis等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.07

6962

6

redis缓存一般存些什么数据
redis缓存一般存些什么数据

redis缓存中存储的数据类型包括:字符串、哈希、列表、集合、有序集合、位图、地理空间数据和hyperloglog。这些数据类型适用于存储各种数据,从简单信息到复杂对象和地理位置。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.07

1160

6

热门下载

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

精品课程

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

共0课时 | 0人学习