Spring Boot（二十）：RedisTemplate的序列化

Spring Boot中Redis的使用、添加依赖和配置Redis：

Spring Boot（十七）：集成和使用Redis

RedisTemplate和StringRedisTemplate的简介、序列化方式和适用场景：

Spring Boot（十八）：RedisTemplate和StringRedisTemplate

StringRedisTemplate的常用方法和注意事项：

Spring Boot（十九）：StringRedisTemplate的常用方法和注意事项

RedisTemplate支持Redis提供的所有数据类型（包括String、Hash、List、Set和ZSet等），并提供灵活的配置选项和事务支持，方便开发者与Redis交互。

RedisTemplate的键和值的默认序列化方式都​是JdkSerializationRedisSerializer，​这种序列化方式将Java对象序列化为字节数组存储到Redis中。

JdkSerializationRedisSerializer序列化的问题

RedisTemplate的键和值的默认序列化方式都是JdkSerializationRedisSerializer，产生的问题是：

1、可读性差

通过Redis命令行查看键和值时会显示乱码

2、跨语言不兼容

跨语言服务（如Python、Go）需要访问Redis数据时，无法直接解析Java序列化的键和值，需额外处理

3、类路径强依赖

反序列化键和值时需依赖原始Java类的定义，不同 JVM 版本或类加载器可能反序列化失败

4、数据体积大

JDK序列化会附加类元数据、版本号等信息，导致存储空间占用高

5、性能开销高

JDK序列化的生成和解析速度较慢，影响高并发场景的吞吐量

所以，通常情况下我们推荐键的序列化方式设置为StringRedisSerializer，键的命名建议使用冒号（:）来分隔不同的命名空间，这样可以清晰地表示键的层级关系和所属模块。推荐值的序列化方式设置​为Jackson2JsonRedisSerializer或GenericJackson2JsonRedisSerializer。​

设置键和值的序列化方式

下面的配置类把RedisTemplate的键序列化方式设置为StringRedisSerializer，把值的序列化方式设置为Jackson2JsonRedisSerializer

@Configuration
public class RedisConfig {

    @Bean
    public RedisTemplate<String, Object> redisTemplate (RedisConnectionFactory factory) {
        RedisTemplate<String, Object> template = new RedisTemplate<>();
        template.setConnectionFactory(factory);
        // 设置键的序列化方式为StringRedisSerializer
        template.setKeySerializer(new StringRedisSerializer());
        template.setHashKeySerializer(new StringRedisSerializer());
        // 设置值的序列化方式为Jackson2JsonRedisSerializer
        template.setValueSerializer(valueSerializer());
        template.setHashValueSerializer(valueSerializer());
        //确保配置生效
        template.afterPropertiesSet();
        return template;
    }

    /**
     * 值的序列化方式：Jackson2JsonRedisSerializer
     */
    private RedisSerializer<Object> valueSerializer() {
        // 配置ObjectMapper
        ObjectMapper objectMapper = new ObjectMapper();
        // 支持Java8的日期时间类型（如LocalDateTime）
        objectMapper.registerModule(new JavaTimeModule());
        // 禁用日期序列化为时间戳
        objectMapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);
        // 序列化所有字段（包括私有字段）
        objectMapper.setVisibility(PropertyAccessor.ALL, JsonAutoDetect.Visibility.ANY);
        // 启用多态类型处理（解决反序列化时类型丢失的问题）
        objectMapper.activateDefaultTyping(
                LaissezFaireSubTypeValidator.instance,
                ObjectMapper.DefaultTyping.NON_FINAL,
                JsonTypeInfo.As.PROPERTY
        );
        Jackson2JsonRedisSerializer<Object> serializer = new Jackson2JsonRedisSerializer<Object>(Object.class);
        serializer.setObjectMapper(objectMapper);
        return serializer;
    }
}

注

1、Jackson2JsonRedisSerializer和GenericJackson2JsonRedisSerializer

如果项目中主要处理常见的Java对象，且对泛型的支持要求不高，Jackson2JsonRedisSerializer就可以满足要求。但如果项目中涉及到复杂的泛型类型，或者需要更灵活的序列化定制，那么GenericJackson2JsonRedisSerializer是更好的选择。

2、一致性要求

确保生产者和消费者使用相同的序列化配置

若您想了解更多内容，请关注公众号：图南随笔，vx：tunan66666