使用RedisTemplate序列化时间报错解决方案

一：当我们向redis中存放序列化后的数据时，在序列化时间时可能会出现错误如下：

Could not write JSON: Java 8 date/time type `java.time.LocalDateTime` not supported by default: add Module "com.fasterxml.jackson.datatype:jackson-datatype-jsr310" to enable handling...

二：原因说明

默认情况下，Jackson 库不支持 Java 8 的 LocalDateTime 类型的序列化和反序列化，因此在将对象序列化为 JSON 字符串时会抛出 SerializationException 异常。

三：解决方案
添加如下注释部分，或者直接使用该模板配置文件

/**
 * 支持存储任何对象（JSON 格式）
 * 支持 Java 8 时间（LocalDateTime）
 * 避免 LinkedHashMap 问题（启用类型信息）
 * 支持 Spring Cache（@Cacheable 等注解）
 */
@Configuration
@EnableCaching
public class RedisConfig {

    /**
     * RedisTemplate：用于操作对象（Object）键值
     */
    @Bean
    public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory factory) {
        RedisTemplate<String, Object> template = new RedisTemplate<>();
        template.setConnectionFactory(factory);

        // 设置序列化器
        template.setKeySerializer(new StringRedisSerializer());
        template.setHashKeySerializer(new StringRedisSerializer());

        template.setValueSerializer(jacksonSerializer());
        template.setHashValueSerializer(jacksonSerializer());

        template.afterPropertiesSet();
        return template;
    }

    /**
     * String 类型专用模板
     */
    @Bean
    public StringRedisTemplate stringRedisTemplate(RedisConnectionFactory factory) {
        return new StringRedisTemplate(factory);
    }

    /**
     * RedisCacheManager：支持 Spring Cache 注解（如 @Cacheable）（可选）
     */
    @Bean
    public RedisCacheManager redisCacheManager(RedisConnectionFactory factory) {
        RedisCacheConfiguration defaultConfig = RedisCacheConfiguration.defaultCacheConfig()
                .entryTtl(Duration.ofMinutes(30)) // 默认缓存过期时间
                .disableCachingNullValues()
                .serializeKeysWith(RedisSerializationContext.SerializationPair.fromSerializer(new StringRedisSerializer()))
                .serializeValuesWith(RedisSerializationContext.SerializationPair.fromSerializer(jacksonSerializer()));

        // 为指定 cacheNames 配置不同 TTL
        Map<String, RedisCacheConfiguration> configMap = new HashMap<>();
        configMap.put("userCache", defaultConfig.entryTtl(Duration.ofHours(1)));
        configMap.put("productCache", defaultConfig.entryTtl(Duration.ofDays(1)));

        return RedisCacheManager.builder(factory)
                .cacheDefaults(defaultConfig)
                .withInitialCacheConfigurations(configMap)
                .transactionAware()
                .build();
    }

    /**
     * 自定义 Key 生成策略（可选）
     */
    @Bean
    public KeyGenerator simpleKeyGenerator() {
        return (target, method, params) -> {
            StringBuilder sb = new StringBuilder();
            sb.append(target.getClass().getSimpleName()).append(":")
                    .append(method.getName()).append(":");
            for (Object param : params) {
                sb.append(param.toString()).append("-");
            }
            return sb.toString();
        };
    }

    /**
     * 通用 Jackson JSON 序列化器，支持 Java 8 时间，开启类型信息
     */
    private RedisSerializer<Object> jacksonSerializer() {
        ObjectMapper mapper = new ObjectMapper();
        // 设置可见性
        mapper.setVisibility(PropertyAccessor.ALL, JsonAutoDetect.Visibility.ANY);

        /**
         * 1.支持 Java 8 时间(解决Jackson库不支持 Java8 的LocalDateTime类型的序列化和反序列化，
         * 而导致对象序列化为 JSON 字符串时会抛出 SerializationException 异常。
         */
        mapper.registerModule(new JavaTimeModule());
        mapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);

        /**
         * 启用类型信息，解决反序列化为 LinkedHashMap 的问题
         * java.lang.ClassCastException: class java.util.LinkedHashMap cannot be cast to class <自定义类型>
          */
        mapper.activateDefaultTyping(
                LaissezFaireSubTypeValidator.instance,
                ObjectMapper.DefaultTyping.NON_FINAL,
                JsonTypeInfo.As.PROPERTY
        );

        return new Jackson2JsonRedisSerializer<>(mapper, Object.class);
    }
}

四：使用说明

                如果完全使用的是该配置文件，还是出现报错，则可以将 redis中的库清除一下（flushdb） 然后重新用程序设置后，再获取。