使用COPY命令从Excel向PostgreSQL的person表导数据时遇UTF-8编码错误

嘿，我之前碰到过一模一样的问题！这个报错的核心原因是你的CSV文件里藏了空字节（0x00），而PostgreSQL的UTF8编码完全不允许这种字符存在。下面给你几个实用的解决办法，按需挑选就行：

办法1：先清理CSV里的空字节 #

最直接的方式是预处理文件，把空字节彻底删掉。

• 如果是Linux或macOS系统，直接在终端执行：

sed -i 's/\x00//g' 你的文件名.csv

• 要是用Windows，在PowerShell里这么操作：

(Get-Content 你的文件名.csv -Raw).Replace([char]0x00, '') | Set-Content 你的文件名.csv -Encoding UTF8

处理完成后，再重新执行你的COPY命令就没问题了。

办法2：让COPY命令自动处理错误 #

不想修改源文件的话，PostgreSQL 12及以上版本支持在COPY命令里添加错误处理规则：

• 直接跳过包含空字节的问题行：

COPY person FROM '@@path@@' DELIMITER ',' CSV HEADER ON ERROR SKIP ROW;

• 把非法的空字节替换成合法字符（比如空格）：

COPY person FROM '@@path@@' DELIMITER ',' CSV HEADER ON ERROR REPLACE WITH ' ';

这种方式不用动源文件就能完成导入，不过记得事后检查下数据有没有异常情况。

办法3：临时修改客户端编码（迫不得已再用） #

实在没办法的话，可以临时切换客户端编码来绕过检查，但这个方法有风险——可能会导致其他非LATIN1兼容的字符乱码，所以谨慎使用：

SET client_encoding TO 'LATIN1';
COPY person FROM '@@path@@' DELIMITER ',' CSV HEADER;
SET client_encoding TO 'UTF8';

导入完成后一定要仔细核对数据，避免留下乱码隐患。

小提示 #

• 想定位空字节在哪一行？Linux/macOS可以用grep -n "\x00" 你的文件名.csv直接找到行号；或者用VS Code打开文件，开启「显示控制字符」选项，空字节会显示成一个小方块。
• 顺便确认下你的CSV文件是不是真的UTF8编码，有时候编码不匹配也会引发类似错误，Linux/macOS用file -I 你的文件名.csv就能查看文件编码。

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