如何在 Redis 中正确使用哈希（Hash）结构存储嵌套字典-Python教程-PHP中文网

如何在 Redis 中正确使用哈希（Hash）结构存储嵌套字典

本文详解如何在 Redis 中通过 hset 正确存储带序号键的嵌套字典结构，并安全地读取与反序列化，避免常见参数误用和 JSON 编码位置错误。

本文详解如何在 redis 中通过 `hset` 正确存储带序号键的嵌套字典结构，并安全地读取与反序列化，避免常见参数误用和 json 编码位置错误。

Redis 的哈希（Hash）类型非常适合存储对象型数据，例如你希望构建一个类似 {1: {"key1": "item1"}, 2: {"key2": "item2"}} 的有序映射结构，并将其持久化到 Redis 中。但直接调用 r.hset(key, json.dumps(mapping)) 是无效的——因为 hset 并不接受单个 JSON 字符串作为整体值，而是要求以字段-值对（field-value pairs）的形式写入。

✅ 正确写入方式：`mapping=` 关键字 + 单值 JSON 序列化

关键有两点：

r.hset() 的 mapping 参数必须显式使用关键字传入（不能作为位置参数）；
每个 value 必须是字符串（如 JSON），而 mapping 本身应为 Python dict，其 key 是哈希字段名（如 "1"、"2"），value 是已序列化的字符串。

import json
import redis

r = redis.Redis()

# 假设 total_activs = {"a": "apple", "b": "banana", "c": "cherry"}
mapping = {}
for i, (key, item) in enumerate(sorted(total_activs.items()), start=1):
    mapping[str(i)] = json.dumps({key: item})  # ⚠️ 注意：key 转为字符串（Redis field 必须是 str）

r.hset(f"{group}", mapping=mapping)  # ✅ 正确：显式 keyword + dict of str→str

? 为什么 r.hset(key, json.dumps(mapping)) 失败？
因为 hset(name, *args, **kwargs) 的前两个位置参数是 field 和 value；若只传两个参数，Redis-Py 会尝试将整个 JSON 字符串当作 field，导致语法错误或静默失败。必须用 mapping= 显式声明。

✅ 正确读取方式：批量获取 + 批量反序列化

读取时，r.hmget(key, fields) 返回的是 List[bytes | None]（每个元素对应一个字段的原始值），需逐个 json.loads() 还原为字典：

Sentinal Redis

监控Redis服务器健康状况、内存、性能及BullMQ队列。检查队列深度、失败任务，分析慢查询并诊断问题。

下载

# 获取前3个条目（字段 "1", "2", "3"）
raw_values = r.hmget(f"{group}", ["1", "2", "3"])
top = [json.loads(v) if v else {} for v in raw_values]  # 安全处理可能的 None

print(top)
# 输出示例：[{"a": "apple"}, {"b": "banana"}, {"c": "cherry"}]

# 现在可自然访问：
if top[0]:
    key_1 = next(iter(top[0]))      # 获取第一个 key（如 "a"）
    value = top[0][key_1]          # → "apple"

? 提示：若字段名固定且语义明确（如 "top1"、"top2"），建议统一使用字符串键（如 str(i)），避免整数键在 Redis 中被隐式转换引发兼容性问题。