json_set是mysql 5.7+唯一推荐的安全局部更新方式，可覆盖已有值、创建缺失路径、不破坏其他字段，但需用单引号包裹路径（如'$.user.name'），不自动补全null父节点，且一次调用支持多路径-值对批量更新。

直接结论：JSON_SET 是 MySQL 5.7+ 唯一推荐的“安全局部更新”方式，它能覆盖已有值、自动创建缺失路径、不破坏其他字段，但路径必须用字符串字面量（带引号），且不能递归补全 NULL 父节点。

JSON_SET 路径写法必须加单引号包裹

常见错误是把 '$.user.name' 写成 $.user.name —— 后者会被 MySQL 当作未定义变量报错 Unknown column 'user' in 'field list'。路径是 SQL 字符串参数，不是 JS 表达式。

• 正确：JSON_SET(json_col, '$.user.name', 'Alice', '$.user.active', true)
• 错误：JSON_SET(json_col, $.user.name, 'Alice')（语法错误）
• 数组下标从 0 开始，'$[0].id' 合法，'$[-1].id' 会报错
• 布尔值写 true/false，别写 "true"，否则存进去是字符串类型

NULL 或非法 JSON 会导致更新静默失败

如果某行的 JSON 字段是 NULL，或内容不是合法 JSON（比如 '{"a":}'），JSON_SET 会返回 NULL，整条记录看起来“没变”，但其实更新失败了。

wechat-article-extraction-mp-weixin-qq-com news-webpage-cleaning blog-post-parsing metadata-extraction-title-author-date multiple-output-formats-markdown-json-plain-text batch-processing-support

基于三引擎设计，从微信文章、新闻和博客网页提取干净内容，支持标题作者日期元数据，多格式和批量处理。

下载

• 务必加过滤条件：WHERE json_col IS NOT NULL AND JSON_VALID(json_col)
• 想兜底处理，用 COALESCE(json_col, '{}') 提供默认空对象：JSON_SET(COALESCE(json_col, '{}'), '$.status', 'done')
• 注意：MySQL 不会自动把 NULL 的父键（如 user）补成空对象；JSON_SET(json_col, '$.user.profile.theme', 'dark') 在 user 为 NULL 时无效

一次调用可更新多个路径，但参数必须成对

不用分多条语句去更新，JSON_SET 支持批量路径-值对，省 IO、保原子性。

• 语法：JSON_SET(json_col, path1, val1, path2, val2, ...)
• 少一个参数就报错：Incorrect parameter count
• 示例：JSON_SET(options, '$.crypto.issuance_volume', 123456789, '$.crypto.market_cap', 987654321)
• 如果某个值是 nil（Go 传 nil），MySQL 会转成 SQL NULL，结果仍是合法更新（不会存字符串 "null"）

和 JSON_REPLACE、JSON_INSERT 的关键区别

选错函数会导致行为完全不符预期：

• JSON_REPLACE：路径不存在就跳过，静默失败 —— 适合“只改已有字段”场景
• JSON_INSERT：路径存在就跳过，只插新字段 —— 适合“初始化默认值”
• JSON_SET：存在则覆盖，不存在则创建 —— 绝大多数动态更新都该用它
• 三者都不修改 JSON 中其他未指定路径的数据，这点一致

最易被忽略的是：即使只改一个字段，MySQL 也要反序列化整个 JSON、修改、再序列化回磁盘 —— 大 JSON 字段频繁更新会明显拖慢写性能。如果字段经常变动，考虑是否真该用 JSON 类型，还是拆成关系表更合适。