结论:必须用JSON_EXTRACT()或->/->>操作符,路径需正确、加JSON_VALID()过滤、关键字段提前提取为生成列,否则将遭遇NULL静默返回和全表扫描问题。

直接说结论:用 JSON_EXTRACT() 或 ->/->> 操作符,路径写对、加 JSON_VALID() 过滤、关键字段提前提取为生成列——否则必掉进 NULL 静默返回和全表扫描两个坑里。
路径写错就静默返回 NULL,不是报错
这是最常误判的点:不管路径不存在、字段名拼错、数组下标越界,还是 JSON 格式本身非法,JSON_EXTRACT(json_col, '$.user.profile.name') 全部返回 NULL,不会报错也不会提示哪错了。
- 顶层字段必须以
$开头,不能漏:写'$.name',别写'name'或'$."name"'(除非 key 含空格或点号) - 数组下标从 0 开始,且必须紧贴方括号:
'$[0].items[2].id'是对的,'$ [0]'或'$.0.name'都无效 - 嵌套对象中的数组要逐层展开:比如
'$.data.items[0].tags[1]',不能跳级写成'$.items[1]' - key 含特殊字符必须双引号包裹:
'$."cpu.freq"'、'$."user id"'
字符串值要用 ->>,别用 JSON_EXTRACT() + JSON_UNQUOTE()
JSON_EXTRACT() 返回的是带双引号的 JSON 类型值(如 "tom"),而 ->> 直接返回去引号后的字符串(tom),类型是 TEXT,更适合 WHERE 条件匹配和程序直取。
- 写
json_col->>'$.name',别写JSON_UNQUOTE(JSON_EXTRACT(json_col, '$.name')) -
->>对数字、布尔、null也去引号,语义不变;但对不存在路径仍返回NULL - WHERE 中做等值判断时,
json_col->>'$.status' = 'active'才可靠;用JSON_EXTRACT()可能因引号导致匹配失败
不加 JSON_VALID() 过滤,脏数据会让结果不可控
如果 JSON 字段是 VARCHAR 类型存的字符串(而非原生 JSON 类型),那里面可能混着纯文本、空字符串、格式错误的 JSON——这些都会让 JSON_EXTRACT() 返回 NULL,进而污染查询逻辑。
exa-js 是 Exa 官方 JavaScript 软件开发工具包,Exa 是一个为 AI 工作流构建的网络搜索 API。它为代理提供了一种具体的方式来搜索网络、检索页面内容,并从代码中生成有来源的答案,而不是手动拼接原始 HTTP 调用。
- 务必在
WHERE子句中前置过滤:WHERE JSON_VALID(json_str) AND json_str->>'$.status' = 'active' - 如果是严格定义的
JSON类型列,插入时已校验,JSON_VALID()可省;但生产环境很多表仍是VARCHAR存 JSON,这步不能跳 - 别把
JSON_EXTRACT()套在 JOIN 条件或子查询里反复调用,性能差且 NULL 传播风险高
高频查询字段必须建生成列 + 索引
JSON_EXTRACT() 是逐行计算函数,无法走索引。哪怕加了 WHERE,执行计划里也必是 type: ALL(全表扫描)。数据量一过万,查询就明显变慢。
- 对常查字段(如状态、分类 ID、用户角色),加生成列:
ALTER TABLE t ADD COLUMN status TEXT GENERATED ALWAYS AS (data->>'$.status') STORED - 再给该列建普通索引:
CREATE INDEX idx_status ON t(status) - 后续查询直接
WHERE status = 'active',就能走索引,避免全表扫描 - 深层嵌套路径(如
'$.config.rules[0].enabled')尽量不作为生成列目标,维护成本高、更新开销大
真正麻烦的从来不是语法怎么写,而是当 JSON_EXTRACT() 返回 NULL 时,你得先分清:是路径写错了?字段压根不存在?还是那条记录存的就是个乱码字符串?没加 JSON_VALID() 就动手解析,等于蒙眼开车。










