spring data redis通过stringredistemplate操作string类型(如set/get/expire/increment),用redistemplate的hashoperations管理hash字段(如put/get/entries),需注意序列化器匹配与field类型统一。

Spring Data Redis 提供了简洁、类型安全的 API 来操作 Redis 的各种数据结构。String 和 Hash 是最常用的数据类型,对应 Redis 的 SET/GET 和 HSET/HGET 等命令。使用时主要依赖 RedisTemplate 或更便捷的 StringRedisTemplate,配合序列化器和操作接口即可高效完成读写。
操作 String 类型:用 StringRedisTemplate 更直观
StringRedisTemplate 默认使用 StringRedisSerializer,专为字符串键值设计,无需额外配置序列化器,适合存取 JSON、纯文本、数字等简单内容。
- 写入字符串:
stringRedisTemplate.opsForValue().set("user:1001", "{\"name\":\"Alice\",\"age\":30}\") - 设置过期时间:
stringRedisTemplate.opsForValue().set("token:abc", "xyz", Duration.ofMinutes(30)) - 读取字符串:
String json = stringRedisTemplate.opsForValue().get("user:1001") - 原子自增(值需为数字字符串):
Long count = stringRedisTemplate.opsForValue().increment("visit:home")
操作 Hash 类型:用 HashOperations 统一管理字段
Hash 适合存储对象的多个属性,如用户信息的 name、email、status 等字段。通过 opsForHash() 获取 HashOperations 实例进行操作。
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis,支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
- 存入单个字段:
redisTemplate.opsForHash().put("user:1001", "name", "Alice") - 批量存入整个 Map:
Map<string object> fields = Map.of("name", "Alice", "email", "a@example.com"); redisTemplate.opsForHash().putAll("user:1001", fields)</string> - 读取单个字段:
Object name = redisTemplate.opsForHash().get("user:1001", "name") - 读取全部字段:
Map<object object> all = redisTemplate.opsForHash().entries("user:1001")</object> - 判断字段是否存在:
Boolean hasEmail = redisTemplate.opsForHash().hasKey("user:1001", "email")
注意序列化器与泛型类型匹配
如果使用通用的 RedisTemplate<object object></object> 操作 Hash,需确保 key 和 hashKey 的序列化方式一致;否则可能因字节不匹配查不到数据。推荐做法:
- String 场景优先用
StringRedisTemplate,避免序列化陷阱 - 需要存 Java 对象(如 User 类)到 Hash 中时,可搭配
Jackson2JsonRedisSerializer配置RedisTemplate,并指定 value 类型为User.class - Hash 的 field(即 hashKey)建议统一用 String 类型,避免用 Integer 或其他类型导致序列化差异
实际使用的小技巧
提升可用性和健壮性,可以结合常见模式优化代码:
- 用
@Cacheable+RedisCacheManager自动缓存方法结果,底层仍是 String 存储序列化值 - 对 Hash 字段做逻辑分组,比如用
"profile"、"stats"作为 field 前缀,便于维护 - 删除整个 Hash:
redisTemplate.delete("user:1001");只删某字段:redisTemplate.opsForHash().delete("user:1001", "email") - 用 pipeline 批量操作提升性能,尤其在循环写入多个 Hash 字段时:
redisTemplate.executePipelined(...)
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










