导出CSV最常踩的坑是WHERE条件错误导致全表或空结果:字符串值漏引号、NULL误用=判断、字符集不匹配;MySQL INTO OUTFILE受secure_file_priv限制;PostgreSQL COPY需注意编码、header和路径。
WHERE 条件写错导致导出全表或空结果
导出 csv 前最常踩的坑不是导出命令本身,而是 sql 查询没过滤干净。比如想导出 status = 'active' 的用户,却漏写了引号写成 status = active,mysql 会把 active 当列名或变量,报错或隐式转为 0;postgresql 则直接报错 column "active" does not exist。
实操建议:
- 先在客户端(如 DBeaver、MySQL CLI)里完整执行一遍带
WHERE的SELECT,确认返回行数和字段值符合预期 - 字符串值必须用单引号,数值可不加,但为统一建议全加:写
WHERE id = '123'比WHERE id = 123更安全(避免类型隐式转换干扰) - 注意 NULL 判断必须用
IS NULL,不能写= NULL—— 后者永远返回 false - 如果条件含中文或特殊字符,确保数据库连接字符集是
utf8mb4,否则导出 CSV 可能乱码或截断
MySQL 用 SELECT … INTO OUTFILE 导出时权限和路径限制
SELECT ... INTO OUTFILE 看似方便,但它写的是数据库服务器本地磁盘,不是你本地电脑。而且默认被禁用:secure_file_priv 配置项会限定只能写入特定目录,常见错误是 ERROR 1290 (HY000): The MySQL server is running with the --secure-file-priv option...。
实操建议:
- 先查当前限制:
SHOW VARIABLES LIKE 'secure_file_priv';,返回空值表示禁用,非空则记住那个路径(比如/var/lib/mysql-files/) - 导出语句必须指定绝对路径,且该路径必须完全匹配
secure_file_priv值(不能是子目录),例如:INTO OUTFILE '/var/lib/mysql-files/export.csv' - 生成的文件属主是 MySQL 进程用户(如
mysql),你可能没有读取权限,需手动chown或用sudo cat拷贝出来 - 不推荐生产环境长期开启此功能,导出敏感数据有风险;临时用完记得检查是否可关闭
PostgreSQL 用 COPY TO 导出 CSV 的编码与分隔符控制
COPY ... TO 是 PostgreSQL 最原生的导出方式,但默认不加 header,也不自动处理 CSV 转义。如果你直接导出含逗号、换行或双引号的字段,Excel 打开会错列——这不是 bug,是标准 CSV 行为,但容易被忽略。
实操建议:
- 强制加表头并指定 UTF8 编码:
COPY (SELECT * FROM users WHERE created_at > '2024-01-01') TO '/tmp/export.csv' WITH (FORMAT CSV, HEADER true, ENCODING 'UTF8'); - 字段含特殊字符时,
QUOTE和ESCAPE默认用双引号,无需额外设;但若数据里本身有双引号,PostgreSQL 会自动翻倍("→""),这是标准行为,Excel 能正确识别 - 注意
COPY TO写的是数据库服务器路径,和 MySQL 一样;想导到本地,得用\copy元命令(psql 客户端内):\copy (SELECT ...) TO '/your/local/path.csv' WITH (FORMAT CSV, HEADER) - Windows 用户注意路径斜杠方向,
C:\temp\export.csv在 psql 里要写成C:/temp/export.csv或用双反斜杠
用命令行工具(mysql / psql)导出时的连接与超时问题
直接在终端敲 mysql -e "SELECT..." > out.csv 看似简单,但字段之间默认用 tab 分隔,不是逗号;而 psql -c "COPY..." 如果没配好 .pgpass,会卡在密码输入,自动化脚本就挂住。
实操建议:
- MySQL 命令行导出 CSV,必须显式指定分隔符和转义:
mysql -B -e "SELECT * FROM t WHERE x=1" | sed 's/\t/,/g' > out.csv;但-B输出含制表符和行首行尾空格,sed处理不彻底,更稳的是用--batch --raw --skip-column-names组合 - PostgreSQL 避免交互式密码:在
~/.pgpass写localhost:5432:mydb:myuser:mypass,并chmod 600 ~/.pgpass,否则脚本无法持续运行 - 大数据量导出容易超时,MySQL 加
--max-allowed-packet=512M,PostgreSQL 在连接串里加options=-c%20statement_timeout=0关闭超时 - 导出前先
SET client_encoding = 'UTF8';(PostgreSQL)或SET NAMES utf8mb4;(MySQL),防止终端 locale 不一致导致乱码
真正麻烦的从来不是“怎么导”,而是导出来的文件能不能被 Excel 无损打开、字段对齐、中文不炸、时间不变成数字——这些细节藏在字符集、分隔符、NULL 表示、引号策略里,改一个参数就可能多一列或少一行。

















