Redis Hash不支持嵌套对象，必须扁平化为一级键值对、存JSON字符串或拆分为独立Key引用；直接存嵌套JSON会丧失字段级操作能力，且无法原生解析路径。
直接把嵌套 JSON 写进 Redis Hash 是错的——Hash 只支持扁平键值对，hset 无法原生解析 {"user":{"profile":{"name":"Alice"}}} 这类结构，强行拆解会丢失嵌套语义、引发字段覆盖或类型错乱。
为什么不能直接用 hset 存嵌套 JSON 字符串
Redis 的 hash 类型底层是字典，每个 field 必须是字符串，value 也必须是字符串。如果你把整个 JSON 对象序列化成一个字符串再塞进某个 field（比如 hset user:123 data '{"profile":{...}}'），那就退化成了 string 存储，完全没用上 Hash 的字段级操作能力。
常见错误现象包括：
- 调用
hget user:123 profile返回空——因为真正存的是data字段，不是profile - 手动 flatten 字段时，遇到同名 key（如
user.profile.name和user.settings.name）发生覆盖 - 反序列化时需重新拼装结构，逻辑耦合高、易出错
正确做法：只对一级字段做 JSON 序列化 + 手动路径展开
核心原则：Hash 适合存「对象的顶层属性」，而非「任意深度嵌套结构」。若原始结构是 Person{ID int, Name string, Address struct{City,Zip string}}，应只将 ID、Name 直接转字符串存入，而 Address 需展开为 address_city、address_zip 等扁平字段。
实操建议：
- 用 Go 的
json.Marshal处理单个字段值（如Address字段本身是 struct，可先json.Marshal成字符串再存入address_jsonfield） - 避免自动递归展开；用命名约定区分：带
_json后缀的 field 表示其值是 JSON 字符串，业务层负责解析 - 如果字段值是数组或深层嵌套对象，且需频繁按子字段查询，改用 RedisJSON 模块（
JSON.SET），而非 Hash
Go 示例：安全写入 Hash 的典型流程
假设你有如下结构：
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
type User struct {
ID int `json:"id"`
Name string `json:"name"`
Settings map[string]interface{} `json:"settings"` // 动态配置，需保留结构
}
写入 Redis Hash 的推荐方式：
-
ID和Name直接作为 string 写入：hset user:123 id "123" name "Alice" -
Settings先json.Marshal成字符串，再写入：hset user:123 settings_json "{\"theme\":\"dark\",\"notify\":true}" - 不使用
hset user:123 settings.theme "dark"—— Redis 不识别这种点号语法，会当成字面 field 名存进去
对应 Go 代码片段：
settingsJSON, _ := json.Marshal(user.Settings)
redisClient.HSet(ctx, "user:123", map[string]interface{}{
"id": strconv.Itoa(user.ID),
"name": user.Name,
"settings_json": settingsJSON,
})
什么时候该放弃 Hash，转向 RedisJSON？
当你需要以下任一能力时，Hash 就不是合适选择：
- 读取嵌套字段：如
JSON.GET user:123 $.settings.notify - 局部更新：如
JSON.SET user:123 $.settings.theme "light"，无需反序列化整个对象 - 条件查询：如
JSON.ARRINDEX user:123 $.tags "admin"
RedisJSON 模块在内部用 Rax 树存储，支持 O(log n) 路径查找，性能远超应用层手动 flatten + string 解析。但注意：它不是所有 Redis 服务都默认启用，云厂商需单独开启模块（如 Redis Cloud 或阿里云 Redis 版本 ≥6.2 + RedisJSON 2.0）。
最常被忽略的一点：Hash 的字段名长度和数量会影响内存占用——存 100 个短字段比存 1 个长 JSON 字符串更占内存，尤其当字段名重复率高时。是否 flatten，本质是在「网络/序列化开销」和「内存/操作粒度」之间做权衡。
