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

为什么Spring Boot集成Redis后读取不到旧数据_统一序列化方案为StringRedisSerializer

冬敏小哥_5037

冬敏小哥_5037

发布时间:2026-07-05 10:43:07

|

424人浏览过

|

来源于php中文网

原创

根本原因是序列化器不匹配:JdkSerializationRedisSerializer存的数据无法被StringRedisSerializer正确读取,导致反序列化失败、返回null或抛异常;需通过迁移脚本将旧数据用原序列化器取出并转为JSON重存。

为什么spring boot集成redis后读取不到旧数据_统一序列化方案为stringredisserializer

Redis里明明有数据,但Spring Boot读不出来

根本原因不是连接失败或配置错误,而是序列化器不匹配。你用 JdkSerializationRedisSerializer(Spring Boot RedisTemplate 默认)存的数据,现在却用 StringRedisSerializer 去读——就像拿UTF-8解码器去读GBK字节流,必然失败。

典型现象包括:Cannot deserialize value of type、java.lang.ClassCastException、或者直接返回 null 却无报错。这不是“查不到”,是“解不开”。

  • 旧数据是二进制格式(含类名、serialVersionUID等Java元信息),StringRedisSerializer 会尝试把整段字节当UTF-8字符串解析,结果多数字节非法,反序列化中途抛异常
  • StringRedisTemplate 默认用 StringRedisSerializer,但它只能读写纯字符串;若你之前混用了 RedisTemplate 存对象,它完全无法兼容
  • 即使 key 能匹配上,value 反序列化失败也会让 opsForValue().get(key) 静默返回 null

统一改用 StringRedisSerializer 后,怎么读旧数据?

不能“读”,只能“迁移”。StringRedisSerializer 和 JdkSerializationRedisSerializer 是互斥的两种编码体系,没有通用解码路径。你必须主动转换存量数据。

Spring Boot Actuator Analyzer
Spring Boot Actuator Analyzer

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

下载
  • 用原始的 RedisTemplate(带 JDK 序列化器)先取出所有旧 key-value,手动反序列化成 Java 对象
  • 再用新配置的 StringRedisTemplate 或指定 StringRedisSerializer 的 RedisTemplate,把对象转成 JSON 字符串重新写入
  • 推荐脚本化处理:在启动类里加一个 @PostConstruct 方法,扫描特定前缀的 key,逐条迁移,完成后删掉逻辑
  • 切勿在运行时混合使用两套序列化器读写同一组 key,否则数据状态不可控

StringRedisSerializer 真的适合所有场景吗?

只适合 key 和 value 都是纯字符串的场景。一旦涉及 Java 对象(如 User、Map、LocalDateTime),StringRedisSerializer 就无能为力——它不负责类型转换,只做字节 ↔ UTF-8 字符串的直译。

  • 如果你调 redisTemplate.opsForValue().set("user:1", new User()),而 value 序列化器是 StringRedisSerializer,会直接抛 IllegalArgumentException: Cannot serialize
  • 想存对象,必须换 Jackson2JsonRedisSerializer 或 GenericJackson2JsonRedisSerializer,并确保字段可被 Jackson 序列化(如 LocalDateTime 需配 JavaTimeModule)
  • StringRedisTemplate 是开箱即用的安全选择,但它的泛型固定为 <string string></string>,硬编码了序列化行为,灵活性极低

最易被忽略的细节:key 也得统一序列化

很多人只改 setValueSerializer,却忘了 setKeySerializer。Redis 的 key 本质也是字节数组,如果 key 用 JDK 序列化器生成(比如 new byte[]{1,2,3}),而你用 StringRedisSerializer 查 "user:1",压根就不是同一个 key。

  • 检查 CLI 中实际存在的 key 名:执行 KEYS *,看显示的是可读字符串还是乱码(如 \xac\xed\x00\x05t\x00\x07user:1)
  • 若 key 是乱码,说明它也被 JDK 序列化过,此时连 DEL 命令都得用原始序列化方式构造 key 字节数组才能删掉
  • 统一方案必须同时设置:template.setKeySerializer(new StringRedisSerializer()) 和 template.setValueSerializer(new StringRedisSerializer())
  • 线上迁移前,务必在测试环境验证 key 扫描逻辑(SCAN + 模式匹配)是否能覆盖所有目标 key

热门AI工具

更多
AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

豆包大模型

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

DeepSeek

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

UP简历
UP简历 Hot

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

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

WorkBuddy

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

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

相关专题

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

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

2531

2025.08.06

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

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

457

2026.01.26

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

6239

2023.08.02

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

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

4489

2023.11.02

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

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

4035

2023.11.14

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

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

7452

2024.04.02

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

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

643

2024.04.07

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

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

756

2024.04.07

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

0

2026.10.16

热门下载

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

精品课程

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

共0课时 | 0人学习

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

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