mysql升级后JSON_EXTRACT函数报错是比较常见的问题，核心原因通常是新版本对JSON路径语法的校验规则发生了调整，旧版本中部分合法的宽松写法在新版本中会被判定为错误。这类报错会直接影响依赖JSON字段查询的业务逻辑，需要针对性排查修复。
常见报错场景与原因
升级后JSON_EXTRACT报错通常有以下几种典型情况：
- 路径中包含未转义的特殊字符，比如键名包含空格、横杠等字符时，旧版本可能自动兼容，新版本要求必须加双引号包裹
- 使用了旧版本支持的省略美元符号$开头的路径写法，新版本要求路径必须以$作为根节点标识
- 路径中使用单引号包裹键名，新版本要求键名必须使用双引号，单引号会被判定为语法错误
- 数组索引使用了负数或者超出范围的取值，新版本对数组边界校验更严格
JSON路径语法检查要点
排查报错时首先要对照新版本mysql的JSON路径规范检查语法，核心规则如下：
基础路径规则
所有JSON路径必须以$开头，代表JSON文档的根节点。访问对象的键时，如果键名只包含字母、数字、下划线，可以直接跟在.后面，否则必须用双引号包裹键名。
特殊字符处理
如果键名包含空格、中文、横杠、点号等特殊字符，必须使用双引号包裹，并且如果键名内部本身包含双引号，需要做转义处理。例如键名为user-name，正确的路径写法是$.user-name，如果键名是user"name，路径需要写成$."user"name"。
数组访问规则
访问数组元素使用方括号加索引的方式，索引从0开始，不支持负数索引。例如获取数组第一个元素，路径为$.arr[0]，如果数组长度不足，JSON_EXTRACT会返回NULL而不是报错，但如果索引格式错误会直接触发语法报错。
报错修复示例
下面通过几个实际案例展示如何修改旧路径适配新版本：
案例1：键名包含横杠未转义
旧版本可能支持的路径：
-- 旧版本可能不报错，新版本会提示路径语法错误 SELECT JSON_EXTRACT(data, '$.user-name') FROM test_table;
修改为正确路径：
-- 横杠属于特殊字符，键名直接跟在点后面会被判定错误，需要加双引号 SELECT JSON_EXTRACT(data, '$."user-name"') FROM test_table;
案例2：省略根节点美元符号
旧版本可能支持的路径：
-- 旧版本可能兼容无$开头的路径，新版本会报错 SELECT JSON_EXTRACT(data, '.user.name') FROM test_table;
修改为正确路径：
-- 路径必须以$开头 SELECT JSON_EXTRACT(data, '$.user.name') FROM test_table;
案例3：使用单引号包裹键名
旧版本可能支持的路径：
-- 旧版本可能兼容单引号，新版本要求键名必须用双引号 SELECT JSON_EXTRACT(data, '$.'user_name'') FROM test_table;
修改为正确路径：
-- 键名使用双引号包裹 SELECT JSON_EXTRACT(data, '$."user_name"') FROM test_table;
批量排查与修复方法
如果业务中存在大量使用JSON_EXTRACT的语句，可以通过以下方式批量排查：
- 先导出所有包含JSON_EXTRACT的SQL语句，通过正则匹配路径部分，检查是否符合新版本语法规则
- 在测试环境中先执行修改后的语句，验证返回结果是否和旧版本一致，避免修改后逻辑出错
- 如果是存储过程或者函数中使用的JSON_EXTRACT，需要同步修改对应的逻辑，避免遗漏
修复完成后建议对依赖JSON字段的查询、更新逻辑做全量回归测试，确保所有相关功能都能正常运行。
mysqlJSON_EXTRACTJSON路径语法数据库升级修改时间：2026-06-30 11:00:27