jsonb_set是postgresql中唯一可靠更新jsonb嵌套字段的函数,路径必须为text[]数组(如array['profile','email']),新值须为jsonb类型(如'"dark"'::jsonb或true::jsonb),create_missing:=true可自动创建缺失父键,删键需用-操作符而非传null。

jsonb_set 是唯一靠谱的方案,其他拼字符串、|| 合并、to_jsonb() 全量替换,不是覆盖整字段就是不支持嵌套路径——用错就等于写了个假更新。
路径必须是 text[],不是点号字符串
写成 jsonb_set(data, '$.profile.email', ...) 或 jsonb_set(data, 'profile.email', ...) 都会报错:function jsonb_set(jsonb, text, jsonb) does not exist。PostgreSQL 不认点号、不认 JSONPath 字符串。
正确写法只有两种等效形式:
ARRAY['profile', 'email']'{profile,email}'::text[]
数组里每个元素对应一级 key;想改 {"user": {"settings": {"theme": "light"}}} 中的 theme,路径就是 ARRAY['user','settings','theme']。别漏掉任何中间层级。
新值必须是 jsonb 类型,字符串要加双引号再转
直接写 'dark' 会当作文本传入,触发类型不匹配错误。JSONB 的字符串字面量必须带外层双引号,并显式转为 jsonb:
- ✅
'"dark"'::jsonb - ✅
to_jsonb('dark') - ❌
'dark'(text 类型,不合法) - ❌
"dark"(语法错误,未加引号)
数字、布尔值同理:'42'::jsonb 错,'42'::jsonb 也不对——得写 '42'::jsonb?不对,正确是 '42'::jsonb 还是错,必须是 '42'::jsonb?停——其实 42::jsonb 才对;布尔值用 true::jsonb。
create_missing := true 决定父级是否存在
默认 create_missing 是 false,意味着路径中任一中间 key 缺失,整个操作就静默失败(返回原值,不报错,也不生效)。
比如更新 data → 'profile' → 'avatar',但 data 里根本没 profile 这个 key:
-
create_missing := false→ 无变化 -
create_missing := true→ 自动补上"profile": {"avatar": "..."}
注意:这个参数对数组下标无效。想改 items[5].status,但 items 只有 3 个元素,即使设 true 也会报错 array subscript out of bounds。
删 key 不是传 NULL,而是用空对象 + - 操作符
写 jsonb_set(data, ARRAY['email'], NULL, true) 不会删字段,反而让该路径变成 null 值(JSON 里的 null,不是缺失)。
真删 key 要两步走:
- 先用
jsonb_set(..., '{}'::jsonb, true)把目标路径设为空对象 - 再用
- 'email'删除键:(jsonb_set(data, ARRAY['email'], '{}'::jsonb, true)) - 'email'
更常用的是直接组合:data - 'email'(顶层)或 jsonb_set(data, ARRAY['profile'], (data -> 'profile') - 'email', true)(嵌套内删)。
真正卡住人的从来不是语法记不住,而是路径传错类型、新值没转 jsonb、删 key 时误用 NULL——这三处出错,语句看着跑通,数据却不动或变歪。











