PostgreSQL执行COPY导入CSV返回0行的异常问题咨询

核心可能原因分析 #

1. UTF-8字节顺序标记（BOM）干扰 #

Windows下部分编辑器保存UTF-8文件时会自动添加BOM（开头的\xEF\xBB\xBF字节），PostgreSQL的COPY命令在CSV模式下无法识别这个标记，会把它当作表头行的一部分，导致表头与表字段匹配失败，最终判定没有有效数据行。
你提到将第一个CSV内容复制到第二个文件就能成功，大概率是第二个文件无BOM，而原文件带有BOM。可以用十六进制编辑器查看文件开头是否存在EF BB BF这三个字节验证。

2. 换行符格式不兼容 #

Windows默认换行符是CRLF（\r\n），如果原文件是在Linux/macOS环境下生成的（换行符为LF），PostgreSQL在Windows环境下的COPY命令可能无法正确识别行边界，误判为没有可导入的数据行。

3. 文件隐藏损坏或属性异常 #

原文件可能存在文件系统层面的隐藏损坏（比如磁盘扇区错误、缓存异常），或者被设置了特殊属性（如加密、只读），虽然能正常打开查看，但PostgreSQL读取时无法解析内容。复制内容到新文件相当于生成了无损坏的副本，因此能成功导入。

4. CSV模式引号规则冲突 #

你使用了CSV选项，PostgreSQL的CSV模式默认以双引号作为字符串包裹符，但你的CSV用的是单引号。虽然另一个混用分隔符的文件能导入，但原文件表头的单引号与分隔符组合可能触发了解析冲突，导致表头匹配失败，进而无数据行被识别。可以尝试在COPY命令中指定单引号作为引号字符：

COPY public.website_manager_tasks FROM 'C:\upwego_test\csvs\tasks.csv' DELIMITER '|' CSV HEADER QUOTE '''';

验证与解决步骤 #

• 用十六进制编辑器检查原文件开头是否有UTF-8 BOM，若有则去除后重新尝试导入。
• 将原文件换行符统一转为Windows格式（CRLF）：用记事本打开后选择「另存为」，编码选UTF-8（不带BOM）。
• 尝试FROM STDIN方式导入，规避文件本身问题：

  COPY public.website_manager_tasks FROM STDIN DELIMITER '|' CSV HEADER;
  

  手动粘贴CSV内容后输入\.结束，观察是否能成功导入。
• 确认PostgreSQL服务账户有原文件的读取权限（虽然复制文件能成功，该可能性较低，但可排除）。

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