关于redisTemplate.opsForValue().set数据本地redis客户端库中查不到问题的解决记录

博客记录了在使用redisTemplate进行数据存取时,本地redis客户端无法读取到数据的问题。经过分析,问题出在redisTemplate的序列化设置。调整redisTemplate的key与value序列化配置后,解决了乱码问题,使得本地客户端能正常读取存储的数据。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

1.问题背景

项目中需要使用redis缓存数据字典信息,于是将redis整合进了maven工程中,然后使用redisTemplate进行写值、读值测试,发现写、读均正常。然后在本地redis库中,通过key值读取maven工程中刚才通过redisTemplate存储的数值时,发现获取不到,于是需要研究一番,一探究竟,事情就是这么个事情。

2.问题截图

2.1 redisTemplate写值截图(正常)

在这里插入图片描述在这里插入图片描述

2.2 redisTemplate读值截图(正常)

在这里插入图片描述

2.3 本地redis读取 (失败)

在这里插入图片描述

3.问题分析

3.1 redis库连接角度

首先出了这么一个问题,最先能想到的是redis连接出问题。经排查,redis服务器正常启动。ping也能收到pong反馈。排除redis库存连接问题。
在这里插入图片描述

3.2 redis参数角度

redis配置参数中,有一项是数据库的编号。我们知道,redis默认一共有16个库,默认是选取0号库的进行默认存储。然后,我怀疑是工程中配置的是0号库,本地redis读取的是非0号库,于是进行排查。
工程配置:
在这里插入图片描述本地切换至0号库,重新读值
在这里插入图片描述
发现,这个角度还是不能解决问题。排除。

3.3 redisTemplate角度

既然上面两个方向,一直没能解决问题,那么,只得从redisTemlpate角度下手,看能不能找到解决办法。有没有可能因为
redisTemplate.opsForValue().set(“key12”,“Java3q”)

redisTemplate.opsForValue().get(“key12”)

都是属于redis的方法,有没有它俩默认遵循了某种规范,我们直观上没有看到这种规范,而恰恰这种规范在本地redis客户端库中又没有遵循,然后根据key进行查查询就查不出来了呢?

在这里插入图片描述

### 解决 Redis 中出现的乱码问题 Redis 存储的数据如果未经过适当处理可能会导致乱码现象,这通常是因为存储对象时没有正确设置序列化方式所致。以下是针对该问题的具体解决方案。 #### 1. 默认配置下的序列化机制 默认情况下,`RedisTemplate` 使用 `JdkSerializationRedisSerializer` 进行序列化和反序列化操作[^2]。这种序列化器会将 Java 对象转换为字节数组形式保存到 Redis 中,而这些字节流在 Redis 客户端查看时表现为不可读的字符编码(如 `\xAC\xED\x00\x05t...`)。因此,为了防止乱码,可以更改序列化策略。 --- #### 2. 更改字符串键值对的序列化方式 对于简单的字符串键值对场景,推荐使用 `StringRedisSerializer` 来替代默认的序列化器。通过修改 `RedisTemplate` 的配置实现: ```java import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.data.redis.connection.RedisConnectionFactory; import org.springframework.data.redis.core.RedisTemplate; import org.springframework.data.redis.serializer.StringRedisSerializer; @Configuration public class RedisConfig { @Bean public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory factory) { RedisTemplate<String, Object> template = new RedisTemplate<>(); // 设置key采用StringRedisSerializer template.setKeySerializer(new StringRedisSerializer()); template.setHashKeySerializer(new StringRedisSerializer()); // 设置value采用Jackson2JsonRedisSerializer或其他适合的序列化器 template.setValueSerializer(new Jackson2JsonRedisSerializer<>(Object.class)); template.setHashValueSerializer(new Jackson2JsonRedisSerializer<>(Object.class)); template.setConnectionFactory(factory); return template; } } ``` 上述代码中设置了 Key 和 Hash Key 使用 `StringRedisSerializer`,并为 Value 及其哈希结构中的字段指定了 JSON 序列化工具 `Jackson2JsonRedisSerializer`[^3]。 --- #### 3. 配置自定义序列化器 当需要支持复杂类型的对象存储时,可以选择其他更灵活的序列化方案,比如基于 JSON 或 Protobuf 的序列化方法。这里以 JSON 方式为例展示如何调整配置: ##### (a) 添加依赖项 确保项目已引入必要的文件: ```xml <dependency> <groupId>com.fasterxml.jackson.core</groupId> <artifactId>jackson-databind</artifactId> </dependency> ``` ##### (b) 自定义序列化逻辑 利用 `GenericJackson2JsonRedisSerializer` 实现通用化的 JSON 转换功能: ```java template.setValueSerializer(new GenericJackson2JsonRedisSerializer()); template.setHashValueSerializer(new GenericJackson2JsonRedisSerializer()); ``` 这种方式能够自动识别并适配多种数据类型,从而减少手动干预的需求。 --- #### 4. 测试验证效果 完成以上改动之后重新运行测试案例来确认修复成果: ```java package com.zzyl.test; import org.junit.jupiter.api.Test; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.boot.test.context.SpringBootTest; import org.springframework.data.redis.core.RedisTemplate; @SpringBootTest public class RedisTest1 { @Autowired private RedisTemplate<String, Object> redisTemplate; @Test public void testRedis() { redisTemplate.opsForValue().set("BB", "b"); redisTemplate.opsForHash().put("AA", "aa", 11); System.out.println(redisTemplate.opsForValue().get("BB")); // 输出应为 'b' System.out.println(redisTemplate.opsForHash().entries("AA")); // 输出应包含 {'aa': 11} } } ``` 此时再观察 Redis 数据内容就不会存在无法辨识的二进制串了。 --- ### 总结 通过对 `RedisTemplate` 的序列化选项做出合理设定即可有效规避因不当序列化引发的乱码难题。具体而言,可选用更适合业务需求的序列化手段代替原始 JDK 提供的方式;而对于纯文本交互则优先考虑运用 `StringRedisSerializer` 类型简化流程。
评论 5
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

北溟南风起

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值