Spring Boot Redis缓存DefaultSerializer序列化异常：UserDto未序列化

方案1：让UserDto实现Serializable接口 #

Spring Boot Redis默认采用JDK的Serializable序列化机制，要求被缓存的对象必须实现该接口。只需修改UserDto类，实现Serializable接口即可解决问题：

import java.io.Serializable;

public class UserDto implements Serializable {
    // 可选但推荐：添加序列化版本号，避免类结构变更导致反序列化失败
    private static final long serialVersionUID = 1L;
    
    // 你的字段与方法
    private String username;
    private String email;
    // ...其他字段、getter/setter方法
}

修改完成后，Redis即可正常完成UserDto对象的序列化与反序列化操作。

方案2：配置Redis使用JSON序列化（推荐） #

如果不想修改DTO类结构，或者希望缓存内容为可读的JSON格式，可以配置Redis使用Jackson JSON序列化器。创建如下Redis配置类：

import org.springframework.cache.annotation.EnableCaching;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.redis.cache.RedisCacheConfiguration;
import org.springframework.data.redis.cache.RedisCacheManager;
import org.springframework.data.redis.connection.RedisConnectionFactory;
import org.springframework.data.redis.serializer.GenericJackson2JsonRedisSerializer;
import org.springframework.data.redis.serializer.RedisSerializationContext;

@Configuration
@EnableCaching
public class RedisConfig {

    @Bean
    public RedisCacheManager cacheManager(RedisConnectionFactory connectionFactory) {
        RedisCacheConfiguration config = RedisCacheConfiguration.defaultCacheConfig()
                // 指定使用JSON序列化器处理值的序列化
                .serializeValuesWith(RedisSerializationContext.SerializationPair.fromSerializer(new GenericJackson2JsonRedisSerializer()));
        
        return RedisCacheManager.builder(connectionFactory)
                .cacheDefaults(config)
                .build();
    }
}

该方案的优势：

• 无需修改现有DTO类的结构
• 缓存内容为人类可读的JSON格式，便于调试排查
• 避免JDK序列化带来的版本兼容性问题

验证 #

修改完成后重启项目，调用getProfileByUsername方法，Redis将能正常缓存UserDto对象，不再抛出Serialization Exception异常。

内容的提问来源于stack exchange，提问作者Jabed Iqbal Joy