redisTemplate.opsForHash().putAll()非原子操作且不减少网络往返，实际限制在于序列化配置需统一、Map键必须为String、高并发下易覆盖竞态；批量删field须用HashOperations.delete()而非delete(Collection)，pattern删除应优先用Lua脚本。
redisTemplate.opsForHash().putAll() 批量写入 Hash 的实际限制
直接调用 putAll() 看似能一次塞入多个 field-value，但它底层仍是逐个执行 HSET 命令，不是原子操作，也不减少网络往返。更关键的是：如果目标 Hash key 本身不存在，putAll() 会创建它；但如果已存在且部分 field 要覆盖、部分要新增，行为完全正常——这点常被误认为“不生效”。
真正容易出问题的是序列化配置：如果你的 RedisTemplate 没统一设置 hashKeySerializer 和 hashValueSerializer，比如 key 用 StringRedisSerializer 而 value 用了 GenericJackson2JsonRedisSerializer，那么 putAll(Map<string object>)</string> 中的 Object 值可能因反序列化失败导致写入空或乱码。
- 务必检查
redisTemplate.setHashKeySerializer(...)和redisTemplate.setHashValueSerializer(...)是否显式设置 -
putAll()接收的 Map 键必须是 String 类型（否则抛ClassCastException） - 不建议在高并发场景下对同一 Hash key 频繁调用
putAll()，易引发字段覆盖竞态
批量删除 Hash 中多个 field 必须用 delete(Object key, Object... hashKeys)
别用 delete(Collection> keys) ——那是删 Redis 的 top-level keys，和 Hash 内部字段完全无关。正确入口是 HashOperations.delete()，它接受可变参数列表，一次删多个 field：
redisTemplate.opsForHash().delete("cart:1001", "item_123", "item_456", "item_789");
这个调用最终发的是单条 HDEL cart:1001 item_123 item_456 item_789，网络开销低、原子性强。但注意两点：
- 传入的 field 参数类型必须和存入时一致；若当初用 Long 存的 field 名，这里也得传
Long，混用 String 会导致删不掉 - 即使某个 field 不存在，也不会报错，整条命令仍成功返回实际删除数量（
Long类型） - 不能传
null字段名，否则抛IllegalArgumentException
想按 pattern 批量删 Hash 字段？Redis 本身不支持，得自己 scan + hdel
Redis 的 Hash 结构没有类似 KEYS 或 SCAN 的字段级模糊匹配指令。如果你需要删 “所有以 temp_ 开头的 field”，只能先读全量再过滤：
Map<Object, Object> allFields = redisTemplate.opsForHash().entries("cart:1001");
List<Object> toDelete = allFields.keySet().stream()
.filter(k -> k instanceof String && ((String) k).startsWith("temp_"))
.collect(Collectors.toList());
redisTemplate.opsForHash().delete("cart:1001", toDelete.toArray());
这看似三步，但隐患明显：
- 如果 Hash 有上万字段，
entries()会把全部数据拉到 JVM 内存，可能 OOM - 两次网络往返（一次
HGETALL，一次HDEL），中间若有其他客户端写入，可能删错 - 更稳妥的做法是改用 Lua 脚本，在服务端完成匹配与删除，避免数据搬移
Hash 整体删除比删字段更常用，但要注意 key 类型误判
最省事的“批量删”其实是直接删整个 Hash key：redisTemplate.delete("cart:1001")。它等价于 Redis 的 DEL 命令，无论内部有多少字段，都一并清除。但常见错误是：误以为 delete() 只删 Hash 字段，结果把不该删的 String / List 类型 key 也干掉了。
所以，执行前务必确认 key 类型：
- 用
redisTemplate.type("cart:1001")返回DataType.HASH再删，避免误删 - 生产环境建议加日志：
log.debug("Deleting HASH key: {}", key)，尤其涉及用户数据时 - 如果 key 是通过拼接生成（如
"cart:" + userId），确保userId已校验非空、合法，防止删成"cart:null"
Hash 的批量操作表面简单，但序列化、类型一致性、网络往返和原子性边界这几个点，稍不注意就会在压测或上线后暴露。尤其是字段级 pattern 删除，别图省事用 entries()，该上 Lua 就上 Lua。
