jsonb_set更新嵌套键值时路径必须为text[]类型，如ARRAY['user','name']或'{user,name}'；不支持点号字符串、通配符或数组索引表达式；更新数组元素需显式指定下标如ARRAY['items','0','status']；用NULL（非'null'）可删除字段；批量更新宜用CTE预计算避免性能问题。
js
onb_set 更新单个嵌套键值时路径必须是字符串数组
直接传入点号分隔的字符串（比如
）会报错，
的第二个参数要求是
类型。常见错误是写成
，结果提示“function
json
b_set(jsonb, text, jsonb) does not exist”。
正确做法是用花括号或
构造路径：
注意：路径中每个元素都是 key 名，不支持通配符、索引表达式（如
），也不支持负数下标。
更新数组内对象的字段需要先定位到数组项
如果 JSONB 里存的是对象数组（如
），想改第一个 item 的 status，不能直接写
—— 这会试图在
数组上设
字段，而数组没有字段。
必须显式指定数组下标（从 0 开始），且下标要作为路径的一部分：
更新第 0 个 item 的 status：
如果下标是变量（比如来自子查询），用
拼接：
若不确定下标是否存在，
默认不会创建缺失的中间结构；加第四个参数
可启用“自动创建”模式，但对数组下标无效 —— 超出当前长度的下标仍会报错。
用 jsonb_set 替换整个子对象时注意 null 和缺失字段的区别
当目标路径已存在，
直接覆盖；但如果路径不存在，默认行为是不修改原值（除非开启
）。容易混淆的是：
值和“字段不存在”在 JSONB 中语义不同。
Find JSON Path Online
Easily find JSON paths within JSON objects using our intuitive Json Path Finder
下载
例如原数据为
，执行
后变成
；而想彻底删掉
字段，得用
（注意是 SQL
，不是字符串
）。
关键区别：
→ 插入 JSON
值（字段保留）
（无引号）→ 删除该路径对应字段（需配合
默认行为）
批量更新多条记录时慎用子查询返回的 jsonb_set 结果
在
中嵌套复杂子查询（比如从另一张表查新值），PostgreSQL 会为每一行重新计算子查询，可能引发性能抖动。尤其当子查询含 JOIN 或聚合时，实际执行计划可能远超预期。
更稳的做法是先用 CTE 预算好所有新值，再 JOIN 更新：
另外，
是 immutable 函数，但频繁更新大 JSONB 字段仍会触发 TOAST 行膨胀，长期高频写入建议拆出关键字段到普通列。
'user.name'jsonb_settext[]jsonb_set(data, 'user.name', '"Alice"')::jsonbARRAYjsonb_set(data, ARRAY['user', 'name'], '"Alice"')jsonb_set(data, '{user,name}', '"Alice"')'items[0].id'{"items": [{"id": 1, "status": "pending"}]}ARRAY['items', 'status']itemsstatusjsonb_set(data, ARRAY['items', '0', 'status'], '"done"')||jsonb_set(data, ARRAY['items'] || idx::text || ARRAY['status'], '"done"')jsonb_settruejsonb_setcreate_missing := truenull{"config": {"timeout": 30}}jsonb_set(data, ARRAY['config', 'retry'], 'null'){"config": {"timeout": 30, "retry": null}}retryjsonb_set(data, ARRAY['config', 'retry'], NULL)NULL'null''null'nullNULLcreate_missing := falseUPDATE ... SET col = jsonb_set(...)WITH new_values AS (
SELECT id, jsonb_set(data, ARRAY['meta', 'updated_by'], to_jsonb(user_id)) AS new_data
FROM orders o
JOIN users u ON o.owner = u.id
)
UPDATE orders
SET data = nv.new_data
FROM new_values nv
WHERE orders.id = nv.id;jsonb_set