当前位置：首页 > 问答 > 正文

MySQL报错ER_JSON_PARSE_ERROR怎么解决，远程帮你快速排查修复

歧云亭
问答
2026-01-18 11:22:10
2

当你执行SQL语句，特别是操作JSON类型字段时，MySQL突然返回一个“ER_JSON_PARSE_ERROR”的错误，意思就是它告诉你：“你给我这段JSON文本，我读不懂，不符合规矩。” 这个错误很常见，但解决起来通常有清晰的路径可循,下面我们就一步步来远程帮你快速排查和修复。

核心原因：你的JSON字符串格式不正确。

MySQL对JSON格式的要求非常严格，必须完全符合标准，任何微小的瑕疵，比如少个引号、多个逗号，或者用了不该用的字符，都会导致这个错误,我们的排查就从这里开始。

第一步：也是最关键的一步，检查你正在写入或更新的JSON字符串本身。

很多时候，问题就出在SQL语句里那个长长的字符串上，你可能是在代码中拼接了JSON,然后直接传入了SQL。

检查引号： JSON的键和字符串值必须用双引号 包围，不能用单引号，这是最容易出错的地方之一。{'name': '张三'} 是错误的，正确的应该是 {"name": "张三"}。
检查逗号： 检查对象（用包起来的部分）或数组（用[]包起来的部分）内部，最后一个元素后面不能有逗号。{"a": 1, "b": 2,} 是错误的,末尾那个逗号必须去掉。
检查转义字符： 如果你的JSON字符串值里本身包含双引号、反斜杠等特殊字符，你必须用反斜杠 \ 进行转义，如果你的值是 我说："你好"，那么在JSON字符串里应该写成 "我说：\"你好\""，如果你是从程序变量中生成JSON，大多数编程语言的JSON库会自动帮你处理转义，但如果你是手动拼接字符串,就很容易忘记。
检查编码和非打印字符： 字符串里可能混入了不可见的控制字符（比如制表符、换行符在某些情况下处理不当）、或者编码问题导致的乱码，你可以尝试将你的JSON字符串贴到一个在线的JSON验证工具（如 JSONLint）里进行检查,它能精确地告诉你错误在哪一行哪一列。

第二步：检查SQL语句中的引号嵌套是否正确。

你是在SQL语句里直接写JSON字符串吗？比如执行一个像这样的语句：UPDATE table SET json_column = '{"key": "value"}' WHERE ...，这里有一个常见的陷阱：SQL语句本身用的是单引号来定义字符串，而JSON内部又用了双引号，这本身是标准写法，但万一你的JSON字符串值里也包含单引号呢？这就可能引发SQL解析错误,有时也会间接导致JSON解析问题。

解决方法： 最好的实践是不要手动拼接JSON字符串到SQL中，应该使用参数化查询（或称为预处理语句），你先把一个包含占位符（如）的SQL模板发给MySQL，然后再把完整的JSON字符串作为一个参数传过去，这样既能避免引号嵌套的混乱，更是防止SQL注入攻击的关键安全措施，在编程中应该这样写（以Python的PyMySQL为例）：
```
# 错误做法：手动拼接
# json_data = '{"name": "O'Reilly"}'  # 这里的单引号会破坏SQL语句
# cursor.execute("INSERT INTO table (json_col) VALUES ('" + json_data + "')")
# 正确做法：参数化查询
json_data = '{"name": "O\'Reilly"}'  # 即使在值里，也尽量保持JSON规范，对内部单引号进行转义（虽然JSON标准要求双引号，但值里的单引号是允许的，不过转义更安全）
cursor.execute("INSERT INTO table (json_col) VALUES (%s)", (json_data,))
```
根据MySQL官方文档关于预处理语句的说明,使用参数化查询可以有效避免因特殊字符引起的语法错误。

第三步：检查数据来源。

你的JSON数据是从哪里来的？

用户输入： 如果是前端表单提交来的,前端可能没有做严格的验证。
外部API： 你调用了一个第三方接口获取数据，然后存入数据库，这个接口返回的数据可能不是标准的JSON,或者在网络传输中出了错。
文件导入： 你从文件（如CSV、TXT）中读取数据然后构造成JSON,文件内容可能包含破损或特殊格式。

解决方法： 在将数据写入数据库之前，增加一道验证环节，在你所用的编程语言中，先用一个JSON解析函数（如 Python 的 json.loads()，PHP 的 json_decode()）尝试解析一下你准备存入数据库的字符串，如果这个解析失败了，那MySQL肯定也会失败，并且你的程序会抛出异常，你可以在这里捕获异常，打印出有问题的字符串，从而精准定位问题，这相当于在你的代码里设置了一个“检查站”。

第四步：检查数据库客户端和连接编码。

虽然不常见，但在极少数情况下，如果数据库连接使用的字符编码（character set）与JSON字符串的编码不兼容，也可能导致解析错误，JSON字符串中包含emoji表情（需要utf8mb4编码），但你的数据库、表或连接还停留在utf8编码,这可能导致数据损坏。

解决方法： 确保你的MySQL数据库、表以及应用程序连接字符串都使用了支持更广字符集的 utf8mb4 编码，你可以通过执行 SHOW VARIABLES LIKE 'character_set%'; 和 SHOW VARIABLES LIKE 'collation%'; 来查看当前的字符集设置，根据MySQL官方文档对字符集的支持说明，utf8mb4 是推荐的选择,因为它完全支持四字节的Unicode字符。

总结一下排查流程：