RedisTemplate默认序列化方式显示中文乱码的解决

 更新时间:2025年06月06日 10:54:48   作者:qq_29781527  
本文主要介绍了SpringDataRedis默认使用JdkSerializationRedisSerializer导致数据乱码,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧

在 Spring Data Redis 中,存储数据时出现乱码通常是因为 RedisTemplate 的默认序列化方式(JdkSerializationRedisSerializer)将数据存储为二进制格式,而不是可读的字符串格式。要解决这个问题,你可以通过配置 RedisTemplate,使用合适的序列化器(如 StringRedisSerializer 或 Jackson2JsonRedisSerializer)来存储数据。

以下是解决方案和配置示例:

1. 问题原因

  • 默认情况下,Spring Data Redis 使用 JdkSerializationRedisSerializer,它会将对象序列化为二进制格式,导致 Redis 中存储的数据不可读。
  • 如果你希望存储为可读的字符串或 JSON 格式,需要修改 RedisTemplate 的序列化器。

2. 解决方案

通过配置 RedisTemplate,指定 key 和 value 的序列化器。常用的序列化器包括:

  • StringRedisSerializer:将 key 和 value 存储为字符串。
  • Jackson2JsonRedisSerializer:将 value 存储为 JSON 格式。

3. 配置类示例

以下是一个配置类的示例,使用 StringRedisSerializer 和 Jackson2JsonRedisSerializer

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.Jackson2JsonRedisSerializer;
import org.springframework.data.redis.serializer.StringRedisSerializer;
import com.fasterxml.jackson.annotation.JsonTypeInfo;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.jsontype.impl.LaissezFaireSubTypeValidator;

@Configuration
public class RedisConfig {

    @Bean
    public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory redisConnectionFactory) {
        RedisTemplate<String, Object> template = new RedisTemplate<>();
        template.setConnectionFactory(redisConnectionFactory);

        // 使用 StringRedisSerializer 序列化 key
        template.setKeySerializer(new StringRedisSerializer());
        template.setHashKeySerializer(new StringRedisSerializer());

        // 使用 Jackson2JsonRedisSerializer 序列化 value
        Jackson2JsonRedisSerializer<Object> serializer = new Jackson2JsonRedisSerializer<>(Object.class);
        ObjectMapper objectMapper = new ObjectMapper();
        objectMapper.activateDefaultTyping(
            LaissezFaireSubTypeValidator.instance,
            ObjectMapper.DefaultTyping.NON_FINAL,
            JsonTypeInfo.As.PROPERTY
        );
        serializer.setObjectMapper(objectMapper);

        template.setValueSerializer(serializer);
        template.setHashValueSerializer(serializer);

        return template;
    }
}

4. 配置说明

  • StringRedisSerializer
    • 用于序列化 key 和 hash key,确保 key 是字符串格式。
  • Jackson2JsonRedisSerializer
    • 用于序列化 value 和 hash value,将对象存储为 JSON 格式。
    • 通过 ObjectMapper 配置支持多态类型(activateDefaultTyping),以便反序列化时能正确还原对象类型。

5. 使用示例

配置完成后,RedisTemplate 会自动使用新的序列化器。以下是一个简单的使用示例:

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.data.redis.core.RedisTemplate;
import org.springframework.stereotype.Service;

@Service
public class UserService {

    @Autowired
    private RedisTemplate<String, Object> redisTemplate;

    public void saveUser(String key, User user) {
        redisTemplate.opsForValue().set(key, user);
    }

    public User getUser(String key) {
        return (User) redisTemplate.opsForValue().get(key);
    }
}

6. 验证存储结果

  • 使用 StringRedisSerializer 和 Jackson2JsonRedisSerializer 后,Redis 中存储的数据将是可读的字符串或 JSON 格式。
  • 例如,存储的 key 会是 user:1,value 会是 {"id":1,"name":"John"}

7. 注意事项

  • 如果已经存储了二进制格式的数据,修改序列化器后,需要手动清理 Redis 中的数据,或者编写迁移脚本将旧数据转换为新格式。
  • 如果存储的是复杂对象(如集合或嵌套对象),确保 ObjectMapper 配置正确,以支持反序列化。

总结

通过配置 RedisTemplate 的序列化器,可以解决 Spring Data Redis 存储数据乱码的问题。推荐使用 StringRedisSerializer 和 Jackson2JsonRedisSerializer,分别处理 key 和 value 的序列化。

到此这篇关于RedisTemplate默认序列化方式显示中文乱码的解决的文章就介绍到这了,更多相关RedisTemplate默认序列化乱码内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • SPFA 算法实例讲解

    SPFA 算法实例讲解

    下面小编就为大家带来一篇SPFA 算法实例讲解。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-07-07
  • Spring中@Autowire注入的深入讲解

    Spring中@Autowire注入的深入讲解

    这篇文章主要给大家介绍了关于Spring中@Autowire注入的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-09-09
  • Java事件监听机制讲解

    Java事件监听机制讲解

    今天小编就为大家分享一篇关于Java事件监听机制讲解,小编觉得内容挺不错的,现在分享给大家,具有很好的参考价值,需要的朋友一起跟随小编来看看吧
    2019-02-02
  • Java Scanner 类读取一维数组二维数组示例详解

    Java Scanner 类读取一维数组二维数组示例详解

    这篇文章主要为大家介绍了Java Scanner 类读取一维数组二维数组示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-11-11
  • WebSocket实现系统后台消息实时通知功能

    WebSocket实现系统后台消息实时通知功能

    在现代Web应用中,提供实时通知对于改善用户体验至关重要,WebSocket技术允许建立双向通信通道,从系统后台将消息实时传送给系统用户,下面我们就来深入探讨一下如何使用WebSocket来实现这一功能吧
    2023-10-10
  • Spring实战之搜索Bean类操作示例

    Spring实战之搜索Bean类操作示例

    这篇文章主要介绍了Spring实战之搜索Bean类操作,结合实例形式分析了Spring搜索Bean类的相关配置、接口实现与操作技巧,需要的朋友可以参考下
    2019-12-12
  • java后台调用HttpURLConnection类模拟浏览器请求实例(可用于接口调用)

    java后台调用HttpURLConnection类模拟浏览器请求实例(可用于接口调用)

    这篇文章主要介绍了java后台调用HttpURLConnection类模拟浏览器请求实例,该实例可用于接口调用,具有一定的实用价值,需要的朋友可以参考下
    2014-10-10
  • Mysql json类型字段Java+Mybatis数据字典功能的实践方式

    Mysql json类型字段Java+Mybatis数据字典功能的实践方式

    这篇文章主要介绍了Mysql json类型字段Java+Mybatis数据字典功能的实践方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-08-08
  • java实现简单学生成绩管理系统

    java实现简单学生成绩管理系统

    这篇文章主要为大家详细介绍了java实现简单学生成绩管理系统,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2022-02-02
  • 模拟简单Java线程池的方法详解

    模拟简单Java线程池的方法详解

    这篇文章主要为大家详细介绍了模拟简单Java线程池的方法,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下,希望能够给你带来帮助
    2022-03-03

最新评论