MySQL JSON_REMOVE 怎样一次删除多个路径
批量清理 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,后面的路径依次类推。对于对象成员,几个互不影响的路径并列写最直观;如果路径之间存在父子关系,就要把“前一步已经改变了什么”考虑进去。

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

修复动作:把边界参数分成可忽略、返回 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 条件,并让应用层记录删除前后的业务主键,而不是把“路径不存在”当成成功删除的证据。
防复发:上线前用四个问题检查多路径删除
- 这些 path 是互不相关的对象成员,还是存在父子关系?父路径是否会让后续路径失效?
- 路径是否指向数组?如果是,多个下标是否已经按从大到小排序?
- 输入 JSON、路径参数和待更新行是否可能为 NULL?NULL 是否应该被拒绝?
- 是否误用了根路径或通配符?删除范围能否用明确的白名单路径表达?
回到开头的脱敏场景,推荐的最小原则是:对象字段一次并列传入,数组下标倒序传入,缺失路径按幂等操作理解,非法路径在 SQL 生成阶段拦截。这样既能减少重复更新,也能让最终 JSON 的变化范围保持可解释。
相关问题
JSON_REMOVE 删除不存在的字段会报错吗?
不会。只要 path 本身合法,目标元素不存在时该路径不影响文档;但这也意味着拼写错误可能被静默忽略,需要结合业务记录判断。
为什么数组要从后往前删除?
因为删除一个元素后,后面的元素会左移。按下标降序删除可以避免前面删除动作改变后面尚未处理目标的位置。
JSON_REMOVE 能用通配符一次删掉一类字段吗?
不能。MySQL 文档规定删除路径不能是根路径,也不能包含 * 或 **;需要显式列出允许删除的路径。
MySQL INET6_NTOA 怎样把二进制地址恢复成 IPv6 文本
- 上一篇
- MySQL INET6_NTOA 怎样把二进制地址恢复成 IPv6 文本
- 下一篇
- MySQL INFORMATION_SCHEMA.KEYWORDS 怎样判断字段名是否撞关键字
-
- 数据库 · MySQL | 13分钟前 | MySQL · 性能优化 · binlog · 主从复制 · mysql 二进制日志 binlog_row_image binlog_format 行复制
- MySQL binlog_row_image 怎样选择行事件包含的列
- 244浏览 收藏
-
- 数据库 · MySQL | 14分钟前 | MySQL · 事务 · mysql 行锁 NOWAIT SKIP LOCKED
- MySQL NOWAIT 和 SKIP LOCKED 有什么区别
- 315浏览 收藏
-
- 数据库 · MySQL | 18分钟前 | MySQL · mysql group_concat group_concat_max_len
- MySQL GROUP_CONCAT 怎样控制结果长度和排序
- 152浏览 收藏
-
- 数据库 · MySQL | 33分钟前 | MySQL · 数据库 · mysql IPv6 hex INET6_ATON INET6_NTOA VARBINARY 二进制地址
- MySQL INET6_NTOA 怎样把二进制地址恢复成 IPv6 文本
- 266浏览 收藏
-
- 数据库 · MySQL | 33分钟前 | MySQL · mysql 窗口函数 ROW_NUMBER 每组第一行
- MySQL 窗口函数怎样保留每组排名第一行
- 230浏览 收藏
-
- 数据库 · MySQL | 50分钟前 | MySQL · mysql SOUNDEX 多字节字符 SOUNDS LIKE 中文姓名 近音匹配
- MySQL SOUNDEX 为什么不适合中文姓名近音匹配
- 366浏览 收藏
-
- 数据库 · MySQL | 59分钟前 | MySQL · 压缩 · 数据存储 · mysql compress VARBINARY UNCOMPRESSED_LENGTH UNCOMPRESS 短字符串压缩
- MySQL COMPRESS 为什么会让短字符串占用更多字节
- 338浏览 收藏
-
- 数据库 · MySQL | 15小时前 |
- MySQL INFORMATION_SCHEMA.TABLESPACES_EXTENSIONS 怎样读取表空间的引擎扩展属性
- 214浏览 收藏
-
- 数据库 · MySQL | 16小时前 |
- MySQL session_account_connect_attrs 怎样理解账户范围内的连接属性可见性
- 111浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1110次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1101次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1273次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1215次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1062次使用
-
- MySQL 明明加了索引,为什么查询还是很慢?先查这 6 个点
- 2026-06-27 374浏览
-
- golang MySQL实现对数据库表存储获取操作示例
- 2022-12-22 499浏览
-
- golang 基于 mysql 简单实现分布式读写锁
- 2023-01-07 384浏览
-
- 详解如何利用GORM实现MySQL事务
- 2023-01-07 184浏览
-
- Go语言实现操作MySQL的基础知识总结
- 2023-01-23 265浏览

