如何使用SQL的JSON_EXTRACT函数解析JSON格式字段？-SQL-PHP中文网

mysql的json_extract必须用以$开头的合法json路径表达式，支持点号和方括号写法；含空格或特殊字符的key需单引号包裹，双引号非法；返回json类型值，需cast或json_unquote转换；无法直接索引，应配合生成列优化。

如何使用sql的json_extract函数解析json格式字段？

JSON_EXTRACT 语法和路径表达式怎么写

MySQL 的 JSON_EXTRACT 不接受任意字符串当路径，必须用合法的 JSON 路径表达式（JSON path expression），以 $ 开头，支持点号（.）和方括号（[n]、['key']）两种写法。路径里含空格或特殊字符必须用单引号包裹，比如 $.data.'user name'；纯字母数字 key 可省略引号，但 $.data.user_name 和 $.data."user_name" 都非法——双引号不被支持。

常见错误现象：JSON_EXTRACT(json_col, '$.info.age') 返回 NULL，但字段明明有值——大概率是 JSON 字符串本身格式不合法（比如用单引号包裹字符串、尾部多逗号），或路径大小写/下划线不匹配（JSON 是大小写敏感的）。

嵌套对象：用 $.a.b.c 或 $.a['b']['c']
数组元素：用 $[0] 取第一个，$.list[1].name 取第二个对象的 name 字段
带空格的 key：必须写成 $.data['first name']，不能写 $.data.first name
路径结果为 null 并不意味着函数出错，而是路径不存在或源 JSON 无效

返回值类型和 NULL 处理要特别注意

JSON_EXTRACT 总是返回 JSON 类型值（带引号的字符串、数字、布尔、null 等原生格式），不会自动转成 MySQL 原生类型。比如 JSON_EXTRACT('{"age": 25}', '$.age') 返回的是 JSON 文本 25（无引号），但它是 JSON 类型，不是 INT。如果直接用于 WHERE 条件或算术运算，可能隐式转换失败或行为异常。

更稳妥的做法是配合 CAST(... AS UNSIGNED) 或 JSON_UNQUOTE()：前者适合数值/布尔，后者适合字符串（去掉外层双引号）。例如：

SELECT CAST(JSON_EXTRACT(info, '$.age') AS UNSIGNED) AS age FROM users;

或者：

SELECT JSON_UNQUOTE(JSON_EXTRACT(info, '$.name')) AS name FROM users;

若路径不存在，JSON_EXTRACT 返回 NULL，不是空字符串
JSON_UNQUOTE(NULL) 仍为 NULL，不会报错
对非字符串 JSON 值（如布尔、null）用 JSON_UNQUOTE 会返回 NULL，此时应优先用 CAST

性能影响：为什么不能在 WHERE 中对 JSON_EXTRACT 加索引

MySQL 无法为 JSON_EXTRACT 的计算结果自动建立二级索引。即使你在 WHERE JSON_EXTRACT(data, '$.status') = 'active' 上频繁查询，每次都会全表扫描并解析每个 JSON 字段——尤其当表大、JSON 深或字段多时，性能断崖式下降。

Comprehensive Three.js 3D graphics reference

详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。

下载

真正可行的优化方式只有两个：

用生成列（generated column）+ 普通索引：添加一个 status VARCHAR(20) AS (JSON_UNQUOTE(JSON_EXTRACT(data, '$.status'))) 的 STORED 列，再对其建索引
改用 MySQL 5.7+ 的 -> 操作符（等价于 JSON_EXTRACT）配合虚拟列，原理相同
避免在 JOIN 条件或 ORDER BY 中嵌套多层 JSON_EXTRACT，解析开销会叠加

临时应急可加 EXPLAIN 确认是否走了索引——只要执行计划中 type 是 ALL，就说明没走索引。

和其他 JSON 函数的配合使用场景

单独用 JSON_EXTRACT 很难覆盖复杂需求，常需搭配其他函数：比如取数组长度要用 JSON_LENGTH()，判断字段是否存在要用 JSON_CONTAINS_PATH()，安全取值可用 COALESCE(JSON_EXTRACT(...), '"default"') 再 JSON_UNQUOTE。

典型组合示例：查出 JSON 数组中所有 email 字段（假设 contacts 是数组）：

SELECT 
  JSON_UNQUOTE(JSON_EXTRACT(contacts, CONCAT('$[', seq.seq, '].email'))) AS email
FROM users
JOIN (
  SELECT 0 AS seq UNION SELECT 1 UNION SELECT 2 UNION SELECT 3
) seq ON seq.seq

JSON_CONTAINS_PATH(data, 'one', '$.tags') 比 JSON_EXTRACT(data, '$.tags') IS NOT NULL 更可靠，能区分“字段不存在”和“字段值为 null”
对不确定结构的 JSON，先用 JSON_TYPE(JSON_EXTRACT(...)) 检查返回值类型，再决定后续处理方式
MySQL 8.0+ 支持 JSON_TABLE()，适合把嵌套 JSON 展开成行，比手写多层 JSON_EXTRACT 更清晰

JSON 字段解析最麻烦的从来不是语法，而是数据质量不可控——上游插入时少个引号、多层嵌套深度超限、或字符集不一致导致解析中断，都可能让 JSON_EXTRACT 静默返回 NULL。上线前务必用 JSON_VALID() 批量校验存量数据。