RedisTemplate 的 6 个可配置序列化器属性对比

RedisTemplate 的 6 个可配置序列化器属性对比

RedisTemplate 提供了以下 6 个核心属性,用于分别配置键、值、哈希类型数据的序列化方式:


1. keySerializer
  • 作用 :定义 Redis 的序列化方式。
  • 默认值JdkSerializationRedisSerializer(若未显式配置 stringSerializer)。
  • 推荐序列化器
    • StringRedisSerializer:键通常为字符串,推荐使用此序列化器。
  • 适用场景:确保键为可读的字符串格式。
2. valueSerializer
  • 作用 :定义 Redis 的序列化方式。
  • 默认值JdkSerializationRedisSerializer
  • 推荐序列化器
    • GenericJackson2JsonRedisSerializer:复杂对象自动序列化。
    • FastjsonRedisSerializer:高性能 JSON 序列化。
  • 适用场景:存储复杂对象或需要类型信息的场景。
3. hashKeySerializer
  • 作用 :定义 Redis 哈希类型键 (如 hset key field value 中的 field)的序列化方式。
  • 默认值 :与 keySerializer 相同。
  • 推荐序列化器
    • StringRedisSerializer:哈希字段通常为字符串。
  • 适用场景:确保哈希键的可读性。
4. hashValueSerializer
  • 作用 :定义 Redis 哈希类型值的序列化方式。
  • 默认值 :与 valueSerializer 相同。
  • 推荐序列化器
    • Jackson2JsonRedisSerializer:固定类型值的 JSON 序列化。
  • 适用场景:存储结构化的哈希值(如对象属性)。
5. stringSerializer
  • 作用:基础字符串序列化器,影响其他属性的默认行为。

  • 默认值StringRedisSerializer

  • 推荐配置

    • 统一设置 stringSerializer 可简化键和值的配置:

      java 复制代码
      template.setKeySerializer(template.getStringSerializer());
  • 适用场景:全局统一字符串处理。

6. defaultSerializer
  • 作用 :当其他属性未显式配置时的默认序列化器
  • 默认值JdkSerializationRedisSerializer
  • 推荐配置
    • 若需统一默认行为,可设置为 GenericJackson2JsonRedisSerializer
  • 适用场景:快速配置全局序列化方式。

对比表格

属性 作用域 默认值 推荐序列化器 适用场景
keySerializer Redis 键 JdkSerialization StringRedisSerializer 确保键为可读字符串
valueSerializer Redis 值 JdkSerialization GenericJackson2Json Fastjson 复杂对象或需要类型信息的场景
hashKeySerializer 哈希字段(field) keySerializer StringRedisSerializer 确保哈希键可读
hashValueSerializer 哈希值(value) valueSerializer Jackson2Json Fastjson 结构化哈希值(如对象属性)
stringSerializer 基础字符串配置 StringRedisSerializer 无需修改(直接使用) 统一字符串处理
defaultSerializer 全局默认值 JdkSerialization GenericJackson2Json 快速统一序列化配置

配置示例

java 复制代码
@Bean
public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory factory) {
    RedisTemplate<String, Object> template = new RedisTemplate<>();
    template.setConnectionFactory(factory);
    
    // 1. 键的序列化器(推荐 String)
    template.setKeySerializer(new StringRedisSerializer());
    
    // 2. 值的序列化器(推荐 JSON)
    template.setValueSerializer(new GenericJackson2JsonRedisSerializer());
    
    // 3. 哈希键的序列化器(与 key 保持一致)
    template.setHashKeySerializer(new StringRedisSerializer());
    
    // 4. 哈希值的序列化器(固定类型可选 Jackson2Json)
    template.setHashValueSerializer(new Jackson2JsonRedisSerializer<>(User.class));
    
    // 5. stringSerializer 默认已配置,可继承
    template.setStringSerializer(new StringRedisSerializer());
    
    // 6. defaultSerializer 全局默认(可选)
    template.setDefaultSerializer(new GenericJackson2JsonRedisSerializer());
    
    return template;
}

总结建议

  1. 键和哈希键 :始终使用 StringRedisSerializer,确保可读性。
  2. 值和哈希值
    • 复杂对象 → GenericJackson2JsonRedisSerializer(自动类型)。
    • 固定类型 → Jackson2JsonRedisSerializerFastjson
  3. 全局配置
    • 通过 stringSerializer 统一基础字符串处理。
    • defaultSerializer 用于快速覆盖未显式配置的场景。

根据具体需求选择序列化器,平衡性能、可读性和类型安全性!

相关推荐
地平线开发者10 小时前
J6B vio scenario sample
算法
BothSavage1 天前
Trae远程开发中DeepSeek自定义模型4054错误的排查与修复
算法
小林ixn1 天前
从暴力到KMP:一道题彻底搞懂字符串匹配的前世今生
算法
烬羽1 天前
字符串算法入门:从反转字符串到回文判断,面试不再慌
算法·面试
先吃饱再说2 天前
判断回文字符串,从一行代码到双指针优化
算法
黄敬峰2 天前
深入理解算法核心:从递归思想、数组扁平化到快速排序
算法
得物技术2 天前
从狂野代码到按目标生产:得物推荐 AI Harness 的工程化实践|AICon 演讲整理
人工智能·算法·架构
AI小老六2 天前
SkillOpt 架构拆解:把 Skill 文本当参数,用执行轨迹训练 Agent
后端·算法·ai编程