MySQL(Docker容器)插入含\n的JSON数据报错，求无需改应用的方案

这个问题我之前也碰到过——MySQL的JSON类型对字符串的转义规则要求很严格，直接在SQL里写\n会被当成实际的换行字符，而不是JSON规范要求的转义序列，所以才会抛出"Invalid encoding in string"的错误。下面给你几个不用修改应用的解决方案，按推荐程度排序：

1. 使用JSON_OBJECT()函数构建JSON（最简便） #

直接用MySQL内置的JSON_OBJECT()来生成JSON数据，它会自动处理值中的特殊字符（包括换行符\n），生成符合JSON规范的格式，不用手动转义：

INSERT INTO table (id, json) VALUES (1, JSON_OBJECT('data', 'name: ab \n cost: 5 $ | time: 1 s'));

原理：JSON_OBJECT()会把传入的字符串值里的实际换行符转成JSON字符串要求的\n转义序列，插入数据库后，你查询出来的JSON数据里的\n是正确的转义格式，应用读取后能正常解析成换行效果。

2. 使用参数化查询（Prepared Statements） #

参数化查询是处理这类转义问题的标准做法，MySQL会在绑定参数时自动处理所有特殊字符的转义，避免手动操作的错误：

-- 准备预处理语句
PREPARE insert_stmt FROM 'INSERT INTO table (id, json) VALUES (?, ?)';
-- 定义参数
SET @id_val = 1;
SET @json_val = '{"data": "name: ab \n cost: 5 $ | time: 1 s"}';
-- 执行插入
EXECUTE insert_stmt USING @id_val, @json_val;
-- 释放预处理语句
DEALLOCATE PREPARE insert_stmt;

这种方式不仅能解决换行符的问题，还能避免SQL注入风险，适合批量操作或者重复执行的场景。

3. 用JSON_QUOTE()处理字符串部分（针对已有JSON字符串） #

如果你的JSON内容已经是完整的字符串格式，只是其中的字段值包含换行符，可以用JSON_QUOTE()先处理字段值，再拼接成JSON：

INSERT INTO table (id, json) VALUES (1, CONCAT('{"data": ', JSON_QUOTE('name: ab \n cost: 5 $ | time: 1 s'), '}'));

JSON_QUOTE()会把输入的字符串转成符合JSON规范的字符串字面量，自动转义换行符、双引号等特殊字符，拼接后的JSON就能正常插入了。

为什么之前手动加\\n不行？ #

你手动把\n改成\\n后，插入的JSON里实际存储的是\\n（也就是两个反斜杠加n），而不是JSON规范的\n转义序列，所以应用读取后会把它当成普通字符串，而不是换行符，自然没法实现换行效果。上面的方法都是让MySQL帮你完成正确的转义，确保数据库里存的是符合JSON规范的\n，应用读取后能正常解析。

内容的提问来源于stack exchange，提问作者Parsus77