MySQL 5.7与8.0 JSON功能对比：函数与索引差异详解

MySQL 5.7 与 8.0 的 JSON 支持对比

MySQL 从 5.7.8 版本开始原生支持 JSON 数据类型，提供了基础的操作函数。然而，其 JSON 功能在 MySQL 8.0 中得到了显著增强，从基础可用升级为专业高效。本文将详细对比两个版本在 JSON 支持上的核心差异。

MySQL 5.7 的 JSON 支持：基础可用但限制明显

MySQL 5.7 引入了原生的 JSON 数据类型和一系列基础函数，如 JSON_EXTRACT()、JSON_SET() 等，能够满足基本的存储与查询需求。但其支持存在两个关键限制：

1. 不支持部分更新：修改 JSON 字段的任何部分都需要重写整个值，无法进行原地更新。
2. 不支持函数索引：无法直接在 JSON 路径表达式上创建索引，必须通过生成列进行中转。

常见问题与解决方案

问题一：高并发下的更新瓶颈
执行类似 UPDATE t SET j = JSON_SET(j, '$.name', 'Alice') 的语句会触发整行锁定和字段重写，在高并发场景下容易成为性能瓶颈。

问题二：索引创建的复杂性
尝试直接在 JSON_EXTRACT(j, '$.id') 表达式上创建索引会导致错误。

解决方案：三步走策略
为加速 JSON 路径查询，需要采取以下步骤：

1. 创建生成列：ALTER TABLE t ADD COLUMN user_id INT AS (JSON_EXTRACT(j, '$.id')) STORED
2. 确保生成列类型与提取结果匹配。
3. 在生成列上创建索引：CREATE INDEX idx_user_id ON t(user_id)

其他注意事项

• JSON_VALID() 函数仅返回 0 或 1 表示语法有效性，除非字段设置为 JSON NOT NULL，否则不会自动拦截非法 JSON 数据插入。
• 所有 JSON 操作都是全量处理，对大型 JSON 文档的性能影响显著。

MySQL 8.0 的 JSON 增强：专业级支持

MySQL 8.0 对 JSON 支持进行了重大改进，特别是在 8.0.27 版本之后，引入了真正的部分更新和函数索引支持。

核心改进一：JSON 部分更新

从 MySQL 8.0.27 开始，支持真正的 JSON 部分更新。底层通过优化后的函数实现原子级字段变更，避免了整个 JSON 值的重写，显著降低了锁争用和二进制日志体积。

使用场景对比

• 用户资料表：profile 字段为 JSON，需频繁按 $.user_id 查询。
  • 8.0：可直接创建函数索引 CREATE INDEX idx_user_id ON users((JSON_EXTRACT(profile, '$.user_id')))
  • 5.7：必须创建生成列再维护索引。
• 日志表：event_data 存储大量 JSON，需高频更新其中 $.status 字段。
  • 8.0：部分更新提升性能。
  • 5.7：每次更新都需重写整个 JSON。

核心改进二：函数索引

MySQL 8.0 允许直接在表达式上创建索引，无需生成列中转，简化了索引创建过程。

函数索引的限制

1. 表达式必须是确定性的。
2. 仍受限于 InnoDB 单列索引的长度上限。
3. 不会自动为已有 JSON 字段创建索引。

新增函数与能力

JSON 聚合函数

• JSON_ARRAYAGG()：将多行 JSON 值合并为数组。
• JSON_OBJECTAGG()：将多行键值对合并为 JSON 对象。

增强的路径操作

• JSON_VALUE()：提取标量值，默认去除引号。
• JSON_QUERY()：提取子文档。
• JSON_OVERLAPS()：判断两个 JSON 文档是否有交集。

关键差异与迁移注意事项

函数行为差异

下表概述了关键函数和特性在两个版本中的主要差异：

函数/特性	MySQL 5.7	MySQL 8.0
部分更新	不支持	8.0.27+ 支持
函数索引	不支持	支持
JSON 聚合	不支持	支持 JSON_ARRAYAGG()、JSON_OBJECTAGG()
字符集默认	latin1	utf8mb4
JSON_EXTRACT() 返回	带引号的字符串	带引号的字符串
替代方案	JSON_UNQUOTE(JSON_EXTRACT(...))	可用 JSON_VALUE()

容易踩的坑

1. 类型转换问题：JSON_OBJECTAGG(key, value) 在 8.0 中要求 key 必须是字符串，传入数字会进行隐式转换。
2. 返回值差异：JSON_EXTRACT() 返回带引号的字符串，而 JSON_VALUE() 返回去引号的值。
3. 性能影响：JSON_VALUE() 默认返回 CHAR(32768)，可能影响排序或连接操作的性能。
4. 字符集问题：5.7 默认 latin1，存储中文或 emoji 可能被截断；8.0 默认 utf8mb4，升级时需注意校对规则设置。

升级迁移的关键点

从 MySQL 5.7 迁移到 8.0 时，真正的复杂性在于 MySQL 不会自动为已有 JSON 字段补全索引。迁移后需要：

1. 手动重构表结构，为常用的 JSON 路径创建函数索引。
2. 重写查询逻辑，利用新的 JSON 函数来优化性能。
3. 验证执行计划，确保 JSON 路径表达式在新版本下能正确使用索引。
4. 测试字符集兼容性，特别是涉及大小写敏感比较的函数行为一致性。

关键参数差异

• json_valid()：5.7 返回 TINYINT，8.0 保持一致但对无效 UTF-8 字符的检查更严格。
• max_allowed_packet：影响 JSON 大对象的读写，8.0 中因函数链式调用更常见，更容易触及此上限。
• JSON_DEPTH()、JSON_LENGTH()：8.0 支持更完善的嵌套层级检测。

总结与建议

对于新项目，强烈建议使用 MySQL 8.0 及以上版本，以获得完整的 JSON 支持，特别是部分更新和函数索引功能。

对于从 5.7 升级的项目，需要执行以下步骤：

1. 评估现有 JSON 字段的使用模式。
2. 识别高频查询的 JSON 路径。
3. 创建相应的函数索引。
4. 重写相关查询以利用新特性。
5. 全面测试字符集和排序规则的影响。

MySQL 8.0 的 JSON 支持已经从“基础可用”升级为“专业高效”。充分理解版本差异是安全、高效完成迁移和优化现有 JSON 数据处理逻辑的基础。