MySQL 8.0+使用JSON_SET可安全更新嵌套键值,路径以$开头、支持自动创建中间结构,如JSON_SET(data, '$.user.settings.theme', 'dark');而JSON_REPLACE仅更新已存在路径,不创建新层级。

MySQL 8.0+ 使用 JSON_SET 更新嵌套键值
MySQL 从 8.0 开始原生支持 JSON 函数,JSON_SET 是最直接的更新方式,它会插入或替换指定路径的值,且不破坏其他字段。
常见错误是路径写错:JSON 路径必须以 $ 开头,数组下标用方括号,对象键名用英文点号或双引号包裹(推荐用点号,更简洁)。
- 要更新
data->'$.user.profile.age',写成JSON_SET(data, '$.user.profile.age', 28) - 如果
profile是数组第 0 项里的对象,得写成'$.user.profile[0].age' - 键名含空格或特殊字符,必须用双引号:例如
'$.user."full name"' - 注意:若路径不存在,
JSON_SET会自动创建中间结构;但JSON_REPLACE不会——它只替换已有路径
示例:
一个基于官方 Mailtrap Node.js SDK 构建的 ASE 技能,用于发送事务邮件并与 Mailtrap 沙盒或生产流程协作。它非常适合需要 API 驱动邮件投递、测试邮箱验证和结构化消息自动化的代理工作流。
UPDATE users SET data = JSON_SET(data, '$.user.settings.theme', 'dark') WHERE id = 123;
PostgreSQL 使用 jsonb_set 更新嵌套字段
PostgreSQL 的 jsonb_set 更灵活,但参数多、顺序固定:目标字段、路径数组、新值、是否插入缺失路径(默认 false)。
路径必须是 text[] 类型,比如 '{user,settings,theme}';不能用点号或字符串拼接路径。
- 路径中含数字下标?写成字符串即可:
'{items,0,name}' - 想让缺失的
settings对象自动创建?第 4 个参数传true - 新值必须是
jsonb类型,所以字符串要用to_jsonb('dark')或'"dark"'::jsonb - 别漏掉
WHERE条件——jsonb_set本身不做过滤,全表扫会导致意外覆盖
示例:
UPDATE users SET data = jsonb_set(data, '{user,settings,theme}', '"dark"'::jsonb, true) WHERE id = 123;
SQLite 3.38+ 用 json_insert/json_replace 需谨慎
SQLite 的 JSON 支持较晚(3.38+),且函数语义和 MySQL/PG 差异大:json_replace 只改已有键,json_insert 只插新键,都不自动补全中间层级。
这意味着:如果 user 下没有 profile 对象,json_replace(data, '$.user.profile.age', '28') 完全无效——不会报错,也不会创建 profile。
- 安全做法是先用
json_valid()确认字段是合法 JSON - 再用
json_type(data, '$.user')检查父级是否存在 - 真要确保嵌套结构存在,得链式调用:
json_insert(json_insert(data, '$.user', json_object()), '$.user.profile', json_object()) - 路径中的键名不能含点号或括号,否则解析失败——这是 SQLite JSON 函数的硬限制
跨数据库兼容性差,别指望一条 SQL 走天下
三个主流数据库的 JSON 更新语法互不兼容,连路径写法、函数名、是否自动建路径都不同。写通用逻辑时,别试图抽象成一个“update_json”函数封装——底层差异太大,维护成本远高于按库分别处理。
真正容易被忽略的是 NULL 处理:MySQL 的 JSON_SET 接收 NULL 值会删键,PostgreSQL 的 jsonb_set 传 'null'::jsonb 才删,SQLite 则根本不支持删键操作。业务里一旦涉及“清空某个嵌套字段”,必须按数据库类型单独验证行为。










