如何解决Spring Boot集成Redis后数据被截断的问题_检查序列化后的字节长度限制

夏丽姑娘_9431

夏丽姑娘_9431

2026-07-02

367人浏览

原创

redistemplate默认使用jdkserializationredisserializer,导致字符串存入时添加\xac\xed\x00\x05等二进制头部而显示乱码,并非截断;真截断多源于自定义序列化器中arrays.copyof(..., n)的静默限制。

如何解决spring boot集成redis后数据被截断的问题_检查序列化后的字节长度限制

RedisTemplate 默认序列化器不支持大 String

Spring Boot 2+ 默认使用 JdkSerializationRedisSerializer(除非显式配置),它会对所有值做 Java 原生序列化,导致存入的 String 前后被加上 4–8 字节头部(如 \xAC\xED\x00\x05),再经 Base64 或直接二进制存储。这不是“截断”,而是**乱码显示 + 实际长度膨胀**,容易被误判为内容丢失。

更隐蔽的问题是:某些自定义序列化器(比如早期项目里手写的 CustomStringRedisSerializer)会主动限制字节数,例如强制 Arrays.copyOf(..., 1024) —— 这才是真截断,且不会报错,静默丢数据。

  • 用 Redis CLI 查看 key:执行 get your_key,如果返回乱码或明显比原始字符串短,优先怀疑序列化器
  • 检查代码中是否手动注册了 RedisSerializer 实现类,尤其注意 serialize() 方法里是否有 if (bytes.length > N) return Arrays.copyOf(..., N) 类逻辑
  • 默认 StringRedisSerializer 是安全的,它只做 UTF-8 编解码,无长度限制

正确配置 StringRedisSerializer 避免隐式截断

必须确保 RedisTemplate<string string></string> 的 value 序列化器是 StringRedisSerializer,而不是泛型版 RedisTemplate<string object></string> 配的 GenericJackson2JsonRedisSerializer(后者对纯字符串也加 JSON 包装,体积增大且可能触发底层缓冲区限制)。

推荐配置方式:

Redis Skill - 高性能缓存管理
Redis Skill - 高性能缓存管理

Redis 缓存和数据结构管理技能。通过自然语言操作 Redis,支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。

下载
@Bean
public RedisTemplate<string string> redisTemplate(RedisConnectionFactory factory) {
    RedisTemplate<string string> template = new RedisTemplate();
    template.setConnectionFactory(factory);
    template.setKeySerializer(new StringRedisSerializer());
    template.setValueSerializer(new StringRedisSerializer()); // 关键:不是 GenericJackson2JsonRedisSerializer
    template.setHashKeySerializer(new StringRedisSerializer());
    template.setHashValueSerializer(new StringRedisSerializer());
    template.afterPropertiesSet();
    return template;
}
</string></string>
  • 不要复用 RedisTemplate<string object></string> 存纯字符串,类型擦除 + 序列化器不匹配极易出问题
  • 如果必须用 Object 泛型(比如存多种类型),value 序列化器应选 GenericJackson2JsonRedisSerializer,但需确认 JSON 序列化后总长度未超 Redis 单 value 限制(官方建议 ≤16KB)
  • Spring Boot 2.6+ 默认客户端是 Lettuce,其 socket 缓冲区默认 16MB,一般够用;若仍截断,需查 lettuce.pool.max-active 是否过小导致连接复用异常

验证字节长度是否真超限

Redis 协议本身不限制 value 大小,但实际受内存、网络帧、客户端实现影响。真正需要检查的是:序列化后字节数是否超过你环境中的隐式阈值(如某些代理、监控工具、旧版 Jedis 客户端有 1MB 硬限制)。

快速验证方法:

String raw = "a".repeat(2000); // 构造 2000 字符字符串
byte[] encoded = raw.getBytes(StandardCharsets.UTF_8);
System.out.println("UTF-8 bytes: " + encoded.length); // 输出 2000
// 再用你当前 RedisTemplate 的 valueSerializer 测试:
byte[] serialized = template.getValueSerializer().serialize(raw);
System.out.println("Serialized bytes: " + serialized.length); // 若远大于 2000,说明用了 Jackson 或 JDK 序列化
  • 如果 serialized.length > raw.length * 2,基本可判定用了 JSON/JDK 序列化,不是截断而是膨胀
  • 若 serialized.length == raw.length 但 Redis 中取出来变短,检查是否 Redis 服务端启用了 maxmemory-policy 导致 LRU 淘汰了大 key(但淘汰是删整个 key,不是截断)
  • 生产环境建议加日志:在 set 操作前后打印 value.length() 和 serializer.serialize(value).length,定位发生在哪一层

大 String 场景下更稳妥的替代方案

当单个 value 稳定超过 10KB,不建议强依赖 SET 指令。Redis 对大 value 的读写会阻塞主线程、放大网络延迟、增加 RDB/AOF 文件体积。

  • 拆分为多个 key:用 key:part:001, key:part:002 + HSET 或 LPUSH 组合,应用层拼接
  • 改用外部存储:把大文本存到对象存储(如 S3/OSS),Redis 只存 URL 和元信息
  • 启用压缩:在序列化前用 DeflaterOutputStream 压缩,反序列化时解压(注意 CPU 开销和兼容性)
  • 避免用 StringRedisTemplate 的 opsForValue().set(key, value, timeout) 直接传巨量字符串,改用 execute() 原生命令并控制分片

最常被忽略的一点:问题往往不出在 Redis 或 Spring Boot,而出在开发人员自己写的序列化器里那行 Arrays.copyOf(..., 1024) —— 它安静运行了两年,直到某天运营导入一个长文案才暴露。查代码比调配置更快。

相关文章

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

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

下载

相关标签:

redis 字节

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

相关专题

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

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

2025.08.06

2511

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

4449

19

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

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

2023.11.14

3975

11

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

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

2024.04.02

7332

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

7142

6

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

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

2024.04.07

1160

6

热门下载

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

精品课程

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

共0课时 | 0人学习