MySQL LOAD DATA 怎样处理包含换行的字段

MySQL LOAD DATA 遇到字段内真实换行时，关键不是把换行删掉，而是让文件格式明确区分“字段里的换行”和“记录结束”。最小可用组合是：用 FIELDS TERMINATED BY 声明字段分隔符，用 ENCLOSED BY 包住可能跨行的文本字段，再用非空 ESCAPED BY 处理引号、反斜杠和换行转义。

官方地址：https://dev.mysql.com/doc/refman/8.4/en/load-data.html

先让分隔符和换行边界对应起来

先看文件本身，而不是先改 SQL。下面这段数据中，第三列 remark 的值跨了两行，但它仍然属于第一条记录，因为整个字段被双引号包住：

id,name,remark
1,Alice,"第一行备注
第二行备注"
2,Bob,"没有跨行的备注"

这里的逗号是字段分隔符，换行是通常的记录分隔符，而引号把中间那次换行纳入 remark。如果文件实际使用制表符、Windows 的 \r\n，或导出器使用了别的包裹符，就必须按文件事实改写参数，不能只套用默认值。

用引号与转义保住字段里的真实换行

以常见的逗号文件为例，推荐先用一个临时表或备份表试导入。SQL 中的反斜杠需要按 MySQL 字符串规则书写，所以 ESCAPED BY '\\' 表示使用反斜杠作为转义字符：

LOAD DATA LOCAL INFILE '/data/customer-note.csv'
INTO TABLE customer_note
CHARACTER SET utf8mb4
FIELDS TERMINATED BY ',' ENCLOSED BY '"' ESCAPED BY '\\'
LINES TERMINATED BY '\n'
IGNORE 1 LINES
(customer_id, customer_name, remark);
-- 上面的列清单把文件顺序固定下来，表头只跳过一行
-- ENCLOSED BY 让 remark 内的换行仍属于当前字段
-- ESCAPED BY 保留引号、反斜杠和特殊字符的可解析边界

如果文件来自 Windows，先确认它的行尾是不是回车加换行；是的话将行子句改为 LINES TERMINATED BY '\\r\\n'。如果文件没有包裹字段，而是用反斜杠写成字面转义，例如 第一行\\n第二行，则导入后得到的是实际换行还是两个字符，要结合导出程序的约定验证，不能把所有 \\n 都当成跨行文本。

还有两个容易混淆的边界：LOCAL 让客户端读取文件，不代表它自动修复格式；而 OPTIONALLY ENCLOSED BY 主要解决并非每个字段都带引号的文件，字段内换行的列仍要遵守同一套包裹约定。

把文件位置、字符集和列映射写清楚

LOAD DATA INFILE 与 LOAD DATA LOCAL INFILE 的差别不只是路径：前者由服务端读取并受 FILE 权限和 secure_file_priv 影响，后者由客户端读取，还要满足客户端和服务端允许 local_infile。这一步失败时，先查文件所在主机和权限，不要误判成换行解析问题。

导入后用警告和抽样查询判断是否完整

不要只看命令返回“成功”。先检查受影响行数，再查看警告；如果使用了 IGNORE 或某些 LOCAL 场景，格式或类型问题可能以警告形式继续导入。

SHOW WARNINGS LIMIT 20;
SELECT customer_id, CHAR_LENGTH(remark) AS remark_chars, remark
FROM customer_note
WHERE customer_id IN (1, 2);
-- 警告用于发现类型或列数问题，抽样查询用于确认换行仍在同一字段
-- CHAR_LENGTH 只帮助确认字符数量，不替代对原始文件的比对

如果记录数比文件中的业务记录少很多，先回到分隔符和引号边界；如果记录数对了但备注内容异常，再查字符集、转义字符和列映射。生产导入建议先用小文件覆盖“有换行、含逗号、含引号、空值”四种样本，确认结果后再扩大文件。

相关问题

字段里只有一个换行，也必须加 ENCLOSED BY 吗？

只要字段值可能包含记录分隔符，就应使用明确的包裹约定；否则解析器无法稳定判断该换行是字段内容还是下一条记录。

为什么把 LINES TERMINATED BY 改成空字符串不能解决问题？

它会改变记录边界规则，不能替代引号对字段内容的保护。除非输入本身是没有行终止符的固定布局，否则不要用它掩盖格式不一致。

CSV 里有双引号时怎么避免字段提前结束？

保持非空 ESCAPED BY，并让导出方按同一约定转义内部引号；同时确认包裹符、分隔符和转义符没有互相冲突。

使用 LOCAL 后还需要检查 secure_file_priv 吗？

两者作用不同。LOCAL 主要改变文件由谁读取，服务端仍可能创建临时副本；遇到空间或权限问题应分别检查客户端文件、服务端配置和临时目录。