如何在MySQL 8.0中通过JSON_MERGE_PATCH合并配置对象?

冬萱酱_8416

冬萱酱_8416

2026-07-16

1011人浏览

原创

应使用 json_merge_patch() 而非 json_merge_preserve() 更新配置,因后者会将重复键值转为数组导致类型错误;json_merge_patch() 执行整键替换且任一参数为 null 则结果静默为 null,须用 coalesce 防空并确保字段类型为 json。

如何在mysql 8.0中通过json_merge_patch合并配置对象?

直接用 JSON_MERGE_PATCH(),但必须确保所有输入都是合法 JSON 且非 NULL —— 否则结果静默为 NULL,配置就丢了。

为什么不能用 JSON_MERGE_PRESERVE() 更新配置

配置更新场景下,你只改了 "theme" 和 "lang",其他字段理应保持原样。但 JSON_MERGE_PRESERVE() 遇到重复键会把值塞进数组:{"retry_count": [3, 5]} 这种结构根本没法读取或校验。

  • 它适合日志归档、多版本快照等需要保留历史值的场景,不适合配置覆盖
  • 一旦在 UPDATE 中误用,后续应用读取 retry_count 时可能报类型错误或取到数组而非数字
  • 没有警告,不报错,只悄悄“污染”数据结构

JSON_MERGE_PATCH() 对嵌套对象和数组的真实行为

它不是“合并子字段”,而是“整键替换”:右侧同名键的值(无论对象、数组还是字符串)直接覆盖左侧整个值。

Feishu calendar sync, local ics to json data for AI agent
Feishu calendar sync, local ics to json data for AI agent

将ICS日历文件转为JSON格式,用于飞书日历导入导出及数据集成。

下载
  • SELECT JSON_MERGE_PATCH('{"user": {"id": 1}}', '{"user": {"name": "A"}}') → {"user": {"name": "A"}}(不是 {"user": {"id": 1, "name": "A"}})
  • SELECT JSON_MERGE_PATCH('{"list": [1,2]}', '{"list": 42}') → {"list": 42}(数组被替换成数字,不是报错)
  • SELECT JSON_MERGE_PATCH('{"x": [1,2]}', '{"x": ["a","b"]}') → {"x": ["a","b"]}(数组被整个替换,不是拼接)

实际 UPDATE 语句中必须检查的三件事

直接写 JSON_MERGE_PATCH(config, '{"log_level":"debug"}') 很危险,运行前确认:

  • 字段类型是 JSON:用 SHOW COLUMNS FROM your_table LIKE 'config' 查,不是 VARCHAR 或 TEXT
  • 存量数据通过 JSON_VALID(config):加 WHERE 子句过滤掉非法 JSON,例如 WHERE JSON_VALID(config)
  • 补丁内容是字符串字面量或表达式,不是未转义变量:不要拼接用户输入,避免注入;用参数化查询或 JSON_OBJECT() 构造安全补丁

NULL 值会让整个合并失效

JSON_MERGE_PATCH() 只要任一参数为 NULL,结果就是 NULL —— 不报错,也不提示,UPDATE 后配置字段直接清空。

  • 常见于 LEFT JOIN 后某列为空,或默认值设为 NULL 的 JSON 字段
  • 安全写法:用 COALESCE(config, '{}') 替换左侧,用 COALESCE(patch_json, '{}') 替换右侧
  • 示例:UPDATE users SET config = JSON_MERGE_PATCH(COALESCE(config, '{}'), '{"timeout": 30}') WHERE id = 123

最易被忽略的是字段类型和 NULL 处理 —— 表里看着像 JSON,可能是 VARCHAR 存的字符串;线上 UPDATE 看似成功,实际因 NULL 导致配置被置空,问题往往延后暴露。

相关专题

更多
mysql修改数据表名
mysql修改数据表名

MySQL修改数据表:1、首先查看数据库中所有的表,代码为:‘SHOW TABLES;’;2、修改表名,代码为:‘ALTER TABLE 旧表名 RENAME [TO] 新表名;’。php中文网还提供MySQL的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

2073

6

MySQL创建存储过程
MySQL创建存储过程

存储程序可以分为存储过程和函数,MySQL中创建存储过程和函数使用的语句分别为CREATE PROCEDURE和CREATE FUNCTION。使用CALL语句调用存储过程智能用输出变量返回值。函数可以从语句外调用(通过引用函数名),也能返回标量值。存储过程也可以调用其他存储过程。php中文网还提供MySQL创建存储过程的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.21

1279

5

mongodb和mysql的区别
mongodb和mysql的区别

mongodb和mysql的区别:1、数据模型;2、查询语言;3、扩展性和性能;4、可靠性。本专题为大家提供mongodb和mysql的区别的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.18

735

5

mysql密码忘了怎么查看
mysql密码忘了怎么查看

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql密码忘了怎么办呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.19

2792

5

mysql创建数据库
mysql创建数据库

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql怎么创建数据库呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.25

4648

4

mysql默认事务隔离级别
mysql默认事务隔离级别

MySQL是一种广泛使用的关系型数据库管理系统,它支持事务处理。事务是一组数据库操作,它们作为一个逻辑单元被一起执行。为了保证事务的一致性和隔离性,MySQL提供了不同的事务隔离级别。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

2023.08.08

1079

3

sqlserver和mysql区别
sqlserver和mysql区别

SQL Server和MySQL是两种广泛使用的关系型数据库管理系统。它们具有相似的功能和用途,但在某些方面存在一些显著的区别。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.11

4911

4

mysql忘记密码
mysql忘记密码

MySQL是一种关系型数据库管理系统,关系数据库将数据保存在不同的表中,而不是将所有数据放在一个大仓库内,这样就增加了速度并提高了灵活性。那么忘记mysql密码我们该怎么解决呢?php中文网给大家带来了相关的教程以及其他关于mysql的文章,欢迎大家前来学习阅读。

2023.08.14

4382

7

mysql事务隔离级别
mysql事务隔离级别

mysql规范中定义了四种事务隔离级别,不同的隔离级别对事务的处理有所不同。本专题为大家提供mysql事务隔离级别相关的文章内容,大家可以免费体验。

2023.08.16

5714

11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL vs MySQL
PostgreSQL vs MySQL

共1课时 | 178人学习

使用phpenv集成环境安装极致CMS
使用phpenv集成环境安装极致CMS

共2课时 | 286人学习