MySQL LOAD DATA 读取 CSV 怎样处理

MySQL 用 LOAD DATA 读取 CSV，最容易出错的地方不是 SQL 关键字，而是文件格式和目标表没有对齐。先确认 CSV 的字符集、分隔符、引号、换行符和表头，再决定使用 LOCAL 还是非 LOCAL；如果 CSV 列顺序、空值和日期格式比较复杂，就用用户变量在写入前转换。

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

CSV 的格式要和 LOAD DATA 选项对齐

CSV 如果是 UTF-8、逗号分隔、双引号包裹文本、Windows 换行并带一行表头，可以从下面这条语句开始。这里的注释只说明关键边界，路径和表名要替换成自己的值。

-- 文件在客户端时使用 LOCAL；字符集和 CSV 文件实际编码保持一致
LOAD DATA LOCAL INFILE '/data/orders.csv'
INTO TABLE orders
CHARACTER SET utf8mb4
FIELDS TERMINATED BY ',' OPTIONALLY ENCLOSED BY '"'
LINES TERMINATED BY '\r\n'
IGNORE 1 LINES
(order_no, buyer_name, amount, created_at);

FIELDS TERMINATED BY 决定列分隔符，OPTIONALLY ENCLOSED BY 处理带逗号的文本字段，LINES TERMINATED BY 要和文件实际换行一致。Linux 生成的文件常用 \n；从 Windows 工具导出的文件可能需要 \r\n。CHARACTER SET 描述的是输入文件内容，不是连接客户端的 SET NAMES 替代品。

如果 CSV 中的字段顺序和表结构不同，不要省略列清单。列清单也能让自增主键、导入时间等不在文件中的列保留默认值。对于带 BOM、混合换行或字段内部包含换行的文件，先统一导出格式，否则单靠 SQL 选项很难稳定补救。

LOCAL 和非 LOCAL 的边界

LOCAL 表示客户端程序读取客户端主机上的文件，再把内容发送给服务器；不写 LOCAL 时，由服务器主机直接读取文件。非 LOCAL 通常需要 FILE 权限，并受 secure_file_priv 目录限制；LOCAL 不需要 FILE，但服务端和客户端都必须允许 local_infile。

选择时可以按“文件在哪里”判断：应用或本地 mysql 客户端能访问 CSV，就优先考虑 LOCAL；文件已放进数据库服务器允许的导入目录，再使用非 LOCAL。LOCAL 会在服务器临时目录产生文件副本，大文件导入还要给临时空间留余量。

不要为了绕过权限问题盲目改服务器配置。先查看当前账号权限和 secure_file_priv 的值，再决定把文件放到哪里；生产环境应把导入目录和账号权限限制在必要范围内。

用列清单和用户变量做导入前转换

当 CSV 的金额带空字符串、日期格式不同，或者表字段顺序与文件不同，可以先接收为用户变量，再在 SET 子句中转换。这样比把原始 CSV 直接塞进严格类型字段更容易定位问题。

-- 先接收原始字段，再清理空白、空值、金额和日期
LOAD DATA LOCAL INFILE '/data/orders.csv'
INTO TABLE orders
CHARACTER SET utf8mb4
FIELDS TERMINATED BY ',' OPTIONALLY ENCLOSED BY '"'
LINES TERMINATED BY '\n'
IGNORE 1 LINES
(@raw_no, @raw_name, @raw_amount, @raw_time)
SET order_no = NULLIF(TRIM(@raw_no), ''),
    buyer_name = NULLIF(TRIM(@raw_name), ''),
    amount = CAST(NULLIF(TRIM(@raw_amount), '') AS DECIMAL(12, 2)),
    created_at = STR_TO_DATE(NULLIF(TRIM(@raw_time), ''), '%Y-%m-%d %H:%i:%s');

用户变量的顺序对应 CSV 的顺序，SET 左侧才是目标表字段。这里把空字符串转为 NULL，但目标列若是 NOT NULL，仍会产生警告或错误；日期格式也必须和文件实际内容一致。金额字段不要用隐式转换掩盖脏数据，导入前后应抽样查看原始文件和目标列。

表头、重复键和警告怎样处理

IGNORE 1 LINES 只跳过文件开头的表头，不等于忽略所有错误。遇到重复主键或唯一键时，IGNORE 会丢弃冲突行并继续，REPLACE 会用新行替换已有行；不写两者时，重复键可能让语句报错并停止后续处理。LOCAL 且没有 REPLACE 时具有类似 IGNORE 的错误处理效果，因此不要把它当成严格失败模式。

导入结束后先看客户端显示的受影响行数，再查看警告；如果业务上不能接受静默丢行，先在临时表导入，确认行数、唯一键和关键字段后再写入正式表。

-- 导入完成后查看本次语句产生的警告，便于发现截断或类型转换问题
SHOW WARNINGS LIMIT 20;

-- 抽样检查关键字段，不把“语句执行成功”当成数据质量证明
SELECT order_no, buyer_name, amount, created_at
FROM orders
ORDER BY created_at DESC
LIMIT 10;

常见问题

为什么 CSV 每行都像只有一个字段？

通常是 FIELDS TERMINATED BY 与文件分隔符不一致，例如文件是逗号却按制表符读取；也要检查是否把整行换行符写错。

为什么加了 LOCAL 仍然报错？

服务端或客户端可能禁用了 local_infile，也可能是连接驱动没有允许本地文件传输。先确认两端配置和账号能力，再处理路径问题。

为什么导入成功但数据少了？

检查表头是否被正确跳过、是否使用了 IGNORE、是否存在唯一键冲突，以及 SHOW WARNINGS 是否记录了截断、类型转换或空值问题。