MySQL JSON_MERGE_PATCH 怎样让 JSON null 删除对象成员-Golang学习网

如果补丁 JSON 里的 null 没有被保存成空值，而是让目标对象中的字段消失，通常不是数据丢失，而是 JSON_MERGE_PATCH() 的设计行为：第二个对象把某个同名键设为 JSON null 时，该成员会从合并结果中删除。

结论：要删除 profile.city，把补丁写成 {"city": null}，并把它作为第二个对象传给 JSON_MERGE_PATCH()。要保留 JSON null，则不要把它当成删除补丁使用。

官方地址：https://dev.mysql.com/doc/refman/8.4/en/json-modification-functions.html

触发信号：补丁成功执行但成员消失

线上排查时常见的现象是 SQL 没有报错，合并结果也仍然是合法 JSON，但某个原有键不见了。先看第二个参数是否为对象，以及消失的键是否同时出现在两个对象中。MySQL 8.4 文档说明，JSON_MERGE_PATCH() 遵循 RFC 7396；对象成员按键处理，补丁对象里的 JSON null 不会作为普通值写入结果。

MySQL JSON_MERGE_PATCH 用 JSON null 删除同名对象成员的静态关系图 — 图1：结构说明图，展示原对象、补丁对象与合并结果之间的成员删除关系；这是静态说明图，不是数据库运行截图。

先把问题分成两类：如果字段应当被移除，使用 JSON null 是预期操作；如果字段应当继续存在且值为空，应该改用业务约定的空字符串、空数组或显式保留策略，而不是直接把它放进 JSON Merge Patch 的补丁对象。

快速判断：先看三个参数边界

JSON_MERGE_PATCH() 不等同于简单的字符串拼接，也不等同于 JSON_MERGE_PRESERVE()。处理前按下面三条判断，可以避免把删除、替换和整体覆盖混在一起。

输入形态	结果	运维判断
两个参数都是对象	按键合并，支持递归	同名键由补丁对象决定
同名键的补丁值不是 JSON null	旧值被新值替换，嵌套对象继续递归	检查是否误把替换当成追加
补丁对象的同名键值是 JSON null	该成员不出现在结果中	这是删除语义
第二个参数不是对象	结果直接采用第二个参数	检查调用方是否传错数据形态

MySQL JSON_MERGE_PATCH 对象递归合并、非 null 替换与非对象回退边界说明图 — 图2：边界关系说明图，展示对象递归、同名键替换和第二参数非对象三种处理路径；这是静态说明图，不是运行截图。

处理步骤：用 JSON null 删除对象成员

最小写法是把原对象放在第一个参数，把删除补丁放在第二个参数。下面的 null 位于 JSON 文本中，因此它是 JSON null 字面量。

-- 用补丁对象中的 JSON null 删除同名成员，同时保留其他成员。
SELECT JSON_MERGE_PATCH(
  '{"name":"Lin","city":"Shanghai","age":30}',
  '{"city":null,"role":"operator"}'
) AS merged_json;

-- 结果：{"age": 30, "name": "Lin", "role": "operator"}

这里的 city 同时存在于两个对象，但补丁对象把它设成 JSON null，所以结果删除 city；role 原来不存在且值不是 JSON null，因此会被新增。

处理步骤：嵌套对象会递归合并

删除嵌套成员时，把路径对应的对象写在补丁对象中即可。不要把点号路径直接写成普通键，除非你的 JSON 结构本来就有一个名为 profile.city 的顶层成员。

-- 嵌套对象按键递归合并，只删除 profile.city。
SELECT JSON_MERGE_PATCH(
  '{"profile":{"name":"Lin","city":"Shanghai","timezone":"Asia/Shanghai"}}',
  '{"profile":{"city":null}}'
) AS merged_json;

-- 结果：{"profile":{"name":"Lin","timezone":"Asia/Shanghai"}}

补丁中的 profile 是对象，MySQL 会继续比较它内部的键。name 和 timezone 没有出现在补丁中，会被保留；只有 city 被 JSON null 标记为删除。

回滚路径：写入前保留原文档与补丁

如果该函数用于 UPDATE，建议在同一事务里先保存原 JSON，或至少在审计记录中保存原文档、补丁文档和操作者。这样可以区分“业务主动删除”与“调用方误传 null”。

-- 在事务中先保存原值，再写入合并结果；表名仅作示例。
START TRANSACTION;

-- 审计原文档与补丁，便于定位误删并支持人工恢复。
INSERT INTO account_json_audit (account_id, old_profile, patch_json)
SELECT id, profile, '{"city":null}'
FROM account
WHERE id = 101;

-- 只把合并结果写回目标行。
UPDATE account
SET profile = JSON_MERGE_PATCH(profile, '{"city":null}')
WHERE id = 101;

-- 业务确认无误后提交；发现补丁错误则执行 ROLLBACK。
COMMIT;

如果只是查询预览，不要直接更新表。先在 SELECT 中计算合并结果，再由应用层或人工确认。需要恢复时，应以审计表中的原文档为准，而不是重新构造一个“看起来相反”的补丁。

告警确认：不要混淆 SQL NULL 与 JSON null

最容易造成误判的是两个名字相同但层级不同的值：SQL NULL 是数据库表达式的空值，JSON null 是 JSON 文档中的字面量。前者可能让整个表达式变成 SQL NULL，后者才是在 Merge Patch 对象里表达删除意图的值。

-- 用 JSON 文本中的 null 表达删除，不要把 SQL NULL 当补丁对象。
SELECT JSON_MERGE_PATCH('{"city":"Shanghai"}', '{"city":null}') AS delete_city;

-- 非 null 的字符串 "null" 是普通字符串，不会触发删除。
SELECT JSON_MERGE_PATCH('{"city":"Shanghai"}', '{"city":"null"}') AS keep_string;

-- 检查输入是否为合法 JSON 对象，避免把错误文本送入合并函数。
SELECT JSON_TYPE(CAST('{"city":null}' AS JSON)) AS patch_type;

另外，数组不是按对象成员逐项打补丁的容器。若第二个参数是数组，结果会直接采用第二个参数；因此接入层应先确认收到的是对象形态，再决定是否调用该函数。