JSON_VALUE提取单个标量值时路径必须用单引号包裹,如'$.name';返回字符串、数字或布尔等基础类型,不返回JSON结构;路径须为常量且符合JSONPath语法,不支持动态拼接或通配符;路径不存在时默认返回NULL,可用DEFAULT子句指定默认值;与JSON_EXTRACT本质区别在于前者去引号返回纯值,后者保留JSON格式;MySQL中性能略低,建议高频查询使用生成列+索引;Oracle支持更多错误处理策略,MySQL则需配合JSON_VALID和JSON_CONTAINS_PATH校验数据合法性。

JSON_VALUE提取单个字符串值时路径写法必须加引号
JSON_VALUE返回的是标量,不是JSON片段,所以它只适合取字符串、数字、布尔这些基础类型。常见错误是写$.name却忘了外层引号——实际必须写成'$.name'(单引号包裹路径表达式)。MySQL和Oracle都强制要求这个引号,不加会直接报错Invalid JSON path expression。
路径支持标准JSONPath语法,比如嵌套字段用'$.user.profile.email',数组元素用'$[0].id'。但注意:MySQL 5.7不支持$[*]这种通配,得升级到8.0+才可用。
- 路径字符串必须是常量,不能拼接变量(如
CONCAT('$.', col_name)会报错) - 如果路径不存在,返回NULL;想返回默认值要用第三个参数,如
JSON_VALUE(json_col, '$.age' RETURNING UNSIGNED DEFAULT '0' ON ERROR) - Oracle里
RETURNING子句可指定类型,MySQL则靠后续CAST或类型转换处理
JSON_VALUE和JSON_EXTRACT的区别别混用
JSON_VALUE只返回标量,JSON_EXTRACT返回JSON文本(带引号的字符串或原始JSON结构)。比如JSON_EXTRACT('{"a": "hello"}', '$.a')返回"\"hello\""(双引号包着),而JSON_VALUE返回hello(纯字符串)。
这意味着:做WHERE条件匹配时,用JSON_VALUE更干净;但要保留JSON结构再解析,就得用JSON_EXTRACT。
- 在ORDER BY里直接用
JSON_VALUE(col, '$.score')没问题;但用JSON_EXTRACT会导致排序按字符串而非数值进行 - MySQL中
JSON_VALUE底层调用JSON_EXTRACT再做类型剥离,性能略低,高频查询建议加生成列+索引 - Oracle中
JSON_VALUE支持ERROR ON ERROR和NULL ON ERROR两种策略,默认是后者
MySQL中JSON_VALUE无法直接处理多层嵌套数组
想从{"users": [{"id":1,"tags":["a","b"]}, {"id":2}]}里取第一个用户的第二个tag?JSON_VALUE做不到。它的路径只能返回单个标量,'$.users[0].tags[1]'看似合理,但MySQL 8.0.22之前会报错“Path contains a wildcard or array accessor that is not supported”。
这时候得换思路:先用JSON_EXTRACT拿到整个数组,再用JSON_UNQUOTE和JSON_EXTRACT组合,或者改用JSON_TABLE展开。
- 安全写法:
JSON_UNQUOTE(JSON_EXTRACT(json_col, '$.users[0].tags[1]')) - 需要遍历多个元素时,
JSON_TABLE才是正解,JSON_VALUE天生不适合这类场景 - Oracle支持
JSON_VALUE带WITH CONDITIONAL,但MySQL完全没这功能
JSON_VALUE返回NULL却不报错,容易掩盖数据问题
路径写错、字段不存在、JSON格式损坏——这三种情况JSON_VALUE都静默返回NULL。你查不出原因,除非手动验证源JSON是否合法、路径是否匹配。
建议在关键查询里加一层校验:用JSON_VALID(json_col)确保字段是合法JSON,再用JSON_CONTAINS_PATH(json_col, 'one', '$.required_field')确认路径存在。
- 不要依赖
IS NOT NULL判断字段是否存在,因为即使路径存在但值为null,JSON_VALUE也返回NULL - 调试时临时改成
JSON_EXTRACT看原始结果,能快速区分是路径问题还是值本身为空 - PostgreSQL没有
JSON_VALUE,用->>操作符替代,行为更接近MySQL的JSON_VALUE


















