RedisTemplate操作Hash返回null的主因是序列化器不一致：key、hashKey、value三者序列化方式必须匹配，尤其hashKey须用StringRedisSerializer，value推荐Jackson序列化，否则反序列化失败或读不到数据。
直接说结论：用 RedisTemplate 操作 Hash，关键不在“怎么调 API”，而在于“序列化器配对是否一致”——key、hashKey、value 三者序列化方式不统一，hget 返回 null 或反序列化失败是常态。
为什么 hget 总是返回 null？
这是最常踩的坑：你用 StringRedisSerializer 存了 key 和 hashKey，但 value 用的是 JdkSerializationRedisSerializer（默认），Redis 里存的是字节流，hget 时却按字符串解码，自然读不出内容。
- 检查
RedisTemplate的keySerializer、hashKeySerializer、valueSerializer是否三者匹配 - 如果 value 是 POJO，
hashKey却是字符串（比如"user:1001"），那hashKeySerializer必须是StringRedisSerializer，不能跟valueSerializer共用同一个 JDK 序列化器 -
opsForHash().get(key, hashKey)返回Object，强转前务必判空，且类型要和valueSerializer反序列化目标一致
HashOperations 与 BoundHashOperations 怎么选？
两者底层都是调 HASH 命令，区别只在编码习惯和 key 复用频率：
Redis Skill - 高性能缓存管理
下载
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
- 用
redisTemplate.opsForHash()：适合单次操作，比如只查一个 field ——opsForHash().get("user:1001", "name") - 用
redisTemplate.boundHashOps("user:1001")：适合对同一 hash key 做多次操作，比如先put几个字段，再increment某个计数，最后size()—— 避免反复传"user:1001" -
BoundHashOperations不支持跨 key 事务，如需原子性更新多个 hash，仍得走executePipelined或 Lua 脚本
POJO 存进 Hash 怎么避免乱码和反序列化异常？
别碰 JdkSerializationRedisSerializer 存业务 POJO——它生成的字节流不可读、不跨语言、升级类字段后极易反序列化失败。推荐两条路：
- 方案一（推荐）：用
GenericJackson2JsonRedisSerializer，但注意它要求 POJO 有无参构造 + getter/setter，且需显式指定泛型类型才能安全反序列化：boundHashOps("user:1001").put("profile", userObj)存，读时用(User) boundHashOps("user:1001").get("profile")强转，前提是valueSerializer是 Jackson 且没丢类型信息 - 方案二（更稳）：改用
StringRedisTemplate，手动objectMapper.writeValueAsString(userObj)再存；读时objectMapper.readValue(jsonStr, User.class)—— 控制权全在自己手上，不依赖模板的泛型擦除逻辑 - 无论哪种，
hashKey（如"email"、"age"）必须用StringRedisSerializer，否则hgetall返回的 Map key 是乱码 byte[]
批量操作 Hash 时性能和边界要注意什么？
hgetall 看似方便，但数据量大时容易 OOM 或拖慢 Redis；hmget 虽快，但字段名必须提前知道：
-
opsForHash().entries(key)=HGETALL，返回整个 hash 的 Map，适合小对象（ -
opsForHash().multiGet(key, Arrays.asList("name", "age", "city"))=HMGET，只取指定字段，网络开销小，适合字段明确的场景 - 想查 “所有 age > 25 的用户”，Hash 本身不支持条件查询 —— 别硬搞，该建索引（比如用 Sorted Set 存 age 分值）或换 Elasticsearch
-
boundHashOps(key).size()是HLEN，O(1)，放心用；但boundHashOps(key).values()是HVALS，会把全部 value 拉到内存，慎用于大 hash
真正“优雅”的核心，不是链式调用多漂亮，而是序列化策略从一开始就没埋雷——key 和 hashKey 用字符串序列化，value 用 JSON，所有环节都可 debug、可预期、可协作。其余都是锦上添花。
