登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  数据库 >  MySQL

MySQL JSON_REMOVE 怎样一次删除多个路径

来源:17golang原创

时间:2026-11-19 09:50:48 121浏览 收藏

批量清理 JSON 字段时,最容易出现的误区是把多个路径拆成多条 UPDATE。MySQL 的 JSON_REMOVE() 本身就支持在同一次调用中传入多个 path:JSON_REMOVE(json_doc, path[, path] ...)。对象成员通常可以直接并列删除;但数组下标会在前一个删除完成后左移,所以路径顺序必须先设计好。

官方文档:https://dev.mysql.com/doc/refman/8.4/en/json-modification-functions.html

下面以一次“保存前清理敏感字段”的故障复盘为线索,说明多路径删除怎样写、为什么有时看起来少删了一个字段,以及怎样把边界条件放进上线前检查。

症状:只想删几个字段,却写出了多次 JSON_SET

假设订单事件放在 payload JSON 列中,里面既有用户联系方式,也有链路追踪字段。最初的写法往往是连续更新同一列,代码长、容易漏掉某一步,而且每条语句都增加一次修改机会。

-- 用一个 JSON 文档模拟需要脱敏的事件数据
SET @doc = '{"user":{"name":"Lin","phone":"13800000000","email":"lin@example.com"},"meta":{"trace_id":"t-2026","source":"checkout"}}';

-- 一次调用删除多个对象成员;不存在的路径不会让整次调用失败
SELECT JSON_REMOVE(
    @doc,
    '$.user.phone',
    '$.user.email',
    '$.meta.trace_id'
) AS cleaned_doc;

这次调用的结果应只保留 user.name、meta.source 等未命中的成员。关键点是:除了第一个 JSON 文档参数,后面的参数都是路径,不是“路径和值”成对出现。

根因:多个路径不是同时拍照,而是从左到右连续生效

排查结果显示,MySQL 会先按第一个 path 生成一个新文档,再拿这个新文档处理第二个 path,后面的路径依次类推。对于对象成员,几个互不影响的路径并列写最直观;如果路径之间存在父子关系,就要把“前一步已经改变了什么”考虑进去。

JSON_REMOVE 多个对象路径从原始 JSON 文档指向用户和元数据字段的静态关系说明图
图1:对象路径关系说明图,展示同一次 JSON_REMOVE 调用中的多个独立删除目标;这是静态说明图,不是数据库截图或运行证据。

例如先删除 $.user,再删除 $.user.phone 时,第二条路径已经找不到父对象,因此不会产生额外变化。这样的缺失路径不是异常,往往只说明前一个删除已经覆盖了它。

-- 第一个路径删除父对象,第二个路径随后自然变成缺失路径
SELECT JSON_REMOVE(
    '{"user":{"name":"Lin","phone":"13800000000"},"ok":true}',
    '$.user',
    '$.user.phone'
) AS result_doc;

-- 结果:{"ok": true}
-- 第二个路径没有报错,也不会把已经删除的 user 对象重新创建出来

触发条件:数组下标会左移,顺序不对就像“少删一个”

真正造成误判的是数组。删除数组元素后,后面的元素会向前移动,所以同一调用中的下标并不代表一组固定的原始位置。

-- 先删原下标 0;数组变成 ["review", "done"]
-- 再删当前下标 1,实际删掉的是原下标 2 的 done
SELECT JSON_REMOVE(
    '["draft","review","done"]',
    '$[0]',
    '$[1]'
) AS result_array;

-- 结果:["review"]
-- 若目标是删除原下标 0 和 1,应按从大到小传入路径
SELECT JSON_REMOVE(
    '["draft","review","done"]',
    '$[1]',
    '$[0]'
) AS result_array;

-- 结果:["done"]

因此对象路径可以按业务阅读顺序排列,数组路径则建议先按下标降序排列。更复杂的数组修改还应考虑前面是否删除了整个数组、父节点是否会消失,以及同一数组是否混用了对象路径和位置路径。

JSON_REMOVE 删除数组元素时下标左移的静态关系说明图
图2:数组下标关系说明图,展示删除一个位置后后续位置如何变化;这是静态说明图,不是运行结果截图。

修复动作:把边界参数分成可忽略、返回 NULL 和直接报错三类

多路径写法本身不等于任何路径都安全。可以按下面三类快速判断:

情况处理结果写法建议
路径不存在忽略该路径,其他合法路径继续处理适合兼容不同版本 JSON 结构,但要确认“无变化”不是数据问题
文档或任意参数为 NULL返回 NULL更新前先决定 NULL 是业务值还是应拦截的输入
路径是 $、含 * 或 **、或不是合法 JSON 路径产生错误不要用通配符表达“删除所有字段”,改为明确列出允许删除的路径
-- 缺失路径被忽略,已有路径仍然可以被删除
SELECT JSON_REMOVE(
    '{"id":7,"debug":true}',
    '$.missing',
    '$.debug'
) AS result_doc;

-- 任意参数为 NULL 时,函数返回 NULL;这不是“删除空字段”
SELECT JSON_REMOVE('{"id":7}', NULL) AS null_result;

-- 根路径和通配符不是可接受的删除路径,以下属于非法调用示意
-- SELECT JSON_REMOVE('{"id":7}', '$');
-- SELECT JSON_REMOVE('{"id":7}', '$.*');

如果必须更新表中的 JSON 列,建议先在同一条语句中保留清晰的 WHERE 条件,并让应用层记录删除前后的业务主键,而不是把“路径不存在”当成成功删除的证据。

防复发:上线前用四个问题检查多路径删除

  1. 这些 path 是互不相关的对象成员,还是存在父子关系?父路径是否会让后续路径失效?
  2. 路径是否指向数组?如果是,多个下标是否已经按从大到小排序?
  3. 输入 JSON、路径参数和待更新行是否可能为 NULL?NULL 是否应该被拒绝?
  4. 是否误用了根路径或通配符?删除范围能否用明确的白名单路径表达?

回到开头的脱敏场景,推荐的最小原则是:对象字段一次并列传入,数组下标倒序传入,缺失路径按幂等操作理解,非法路径在 SQL 生成阶段拦截。这样既能减少重复更新,也能让最终 JSON 的变化范围保持可解释。

相关问题

JSON_REMOVE 删除不存在的字段会报错吗?

不会。只要 path 本身合法,目标元素不存在时该路径不影响文档;但这也意味着拼写错误可能被静默忽略,需要结合业务记录判断。

为什么数组要从后往前删除?

因为删除一个元素后,后面的元素会左移。按下标降序删除可以避免前面删除动作改变后面尚未处理目标的位置。

JSON_REMOVE 能用通配符一次删掉一类字段吗?

不能。MySQL 文档规定删除路径不能是根路径,也不能包含 * 或 **;需要显式列出允许删除的路径。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>