DBeaver导入CSV失败八成是编码、分隔符或首行识别不匹配所致:Windows中文CSV多为GBK而DBeaver默认UTF-8,须手动选对编码;分隔符需据文件实际(逗号/分号/制表符)设置;预览页须确认首行是否为列名、空值标识及引号处理,否则解析错位。

直接说结论:DBeaver 导入 CSV 失败,八成不是软件问题,而是编码、分隔符、首行识别这三项没对上——尤其 Windows 生成的中文 CSV 默认是 GBK,而 DBeaver 默认按 UTF-8 解析,不改就乱码,且不报错。
确认 CSV 编码和分隔符再点“下一步”
别信文件后缀或 Excel 显示。用命令行快速验证:file -i your_file.csv 看输出里的 charset;如果显示 charset=iso-8859-1 或没 BOM 又全是中文,基本就是 GBK。DBeaver 向导里必须手动选对,否则整列中文变 ??? 或 。分隔符同理:打开文件用文本编辑器看第一行,是逗号、分号、制表符 \t 还是竖线 |?向导里选错,预览页就会列错位,但你可能只当是数据问题。
- Windows 记事本另存为 CSV → 极大概率
GBK(带 BOM 的 UTF-8 较少) - Excel 导出 CSV(Windows 版)→ 默认
GBK,Mac 版默认UTF-8 - Linux 脚本生成 CSV → 多为
UTF-8,但需确认是否含 BOM
预览页不只看“长得像”,要看切分逻辑是否正确
向导第二步的预览页,不是让你确认“数据看起来正常”,而是检查解析引擎是否把一行真正拆成了预期列数。重点盯三点:
- 首行是表头?勾选
首行为列名,否则第一行数据会被当列名丢掉 - 空值怎么写的?是
NULL、N/A、-还是空字符串?得在向导的Null string栏里填一致,否则全变成0或当前时间 - 带引号的字段含逗号怎么办?比如
"Smith, John",25,"New York"—— 必须勾选Text qualifier并设为",否则会错切成 4 列
列映射阶段最容易忽略“类型强转”和自增列处理
预览看着对,不代表能入库。DBeaver 在列映射页才真正做类型转换,这里几个关键动作常被跳过:
- 数字列里有千分位(如
1,234.56)?目标列是DECIMAL,但源数据是字符串,不处理就报错或截断成1—— 得在映射时点开该列的Transform,选Remove thousands separator - 日期格式五花八门(
2023/05/01、01-MAY-2023)?不能依赖自动识别,必须手动在Date format栏填对应 pattern,如yyyy/MM/dd或dd-MMM-yyyy - 目标表有自增主键
id或数据库生成的created_time?勾选Transfer auto-generated columns才会让 DBeaver 跳过这些列;否则它会试图插入NULL或空值,触发 NOT NULL 报错
“保存任务”不等于导入完成,执行才是关键一步
很多人点完“完成”就以为数据进库了,结果查表为空。DBeaver 的“保存任务”只是把配置存成一个 JSON 文件,真正写库要回到主界面的 Tasks 视图里找到刚保存的任务,右键 Execute。这个设计容易误导,尤其新手常卡在这一步。
另外,批量导入失败时错误信息藏得深:任务执行完不要只看弹窗提示,务必点开底部 Task log 面板,搜索 ERROR 或具体行号(如 Row #1502),那里才有真实解析失败原因——比如某列超长、时区转换异常、或目标列定义为 NOT NULL 但源数据为空。











