当前位置:首页 > 文章列表 > 数据库 > MySQL > MySQL JSON_REMOVE 怎样一次删除多个路径

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

来源:17golang原创 2026-11-19 09:50:48 0浏览 收藏

批量清理 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删除
MySQL INET6_NTOA 怎样把二进制地址恢复成 IPv6 文本MySQL INET6_NTOA 怎样把二进制地址恢复成 IPv6 文本
上一篇
MySQL INET6_NTOA 怎样把二进制地址恢复成 IPv6 文本
MySQL INFORMATION_SCHEMA.KEYWORDS 怎样判断字段名是否撞关键字
下一篇
MySQL INFORMATION_SCHEMA.KEYWORDS 怎样判断字段名是否撞关键字
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1110次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1101次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1273次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1215次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1062次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码