DBeaver 数据导入报错？6 步定位格式冲突并一次跑通-平芜编程栈

DBeaver 数据导入报错？6 步定位格式冲突并一次跑通

【免费下载链接】dbeaverFree universal database tool and SQL client项目地址: https://gitcode.com/GitHub_Trending/db/dbeaver

导入进度条爬到尽头，日志里突然一片红：Duplicate entry一行接一行。DBeaver 数据导入遇到这种报错并不棘手——只要分清是格式问题还是冲突问题，剩下的就是在向导里逐项点确认。下面带你走一遍从"翻车"到"重跑成功"的完整路径。

先别急着改数据。打开导入结果窗口的日志，对照下面这张表，把报错归个类，后面的操作就有方向了：

报错现象	常见原因	去哪解决
整行数据挤在第一列，或大量字段为空	CSV 分隔符与文件实际不一致	导入中·第 1 步
数值列出现字符串、日期显示 Invalid	类型转换失败	导入前·第 3 步
`Duplicate entry 'xxx' for key 'PRIMARY'`	主键或唯一约束冲突	导入中·第 2 步
中文全是`?`或乱码	文件编码与设置不匹配	导入前·第 2 步
进度条走完但提示有行失败	约束导致部分行被丢弃	导入后·第 1 步

卡在这一步很正常，DBeaver 的导入流程把"解析文件"和"写入数据库"分成两段，报错出现在哪一段，决定了你该改哪里的设置。

右键文件 →工具 → 导入数据（或在目标表上右键导入数据再选文件），在文件设置页确认分隔符是逗号、制表符还是自定义字符。文件来自 Excel 导出时，先用文本编辑器看一眼首行，逗号还是分号，别猜。
同页高级设置里选编码（UTF-8 或 GBK），拿不准时同样用文本编辑器确认，含中文的文件这里最容易埋雷；BOM 选项只在目标端明确要求时勾选。
切到列映射页，逐列看目标列的数据类型：CSV 里的001对上是整型列，就会在转换时报错，这类脏值建议先在源文件里洗掉。解析规则的实现可以看 DataImporterCSV.java，它支持自定义分隔符与引号字符。

在目标设置（消费者）页找到冲突处理选项：插入、更新（Upsert）、跳过，三选一。主键冲突想保留旧数据就选跳过，想用新值覆盖就选更新。
勾选忽略重复行错误，导入就不会因为个别主键冲突整批中断。
⚠️ 有个隐性坑：这个忽略选项对批量插入不生效（设置项的官方提示原文如此）。如果你的加载方式勾了批量，就必须靠第 1 步的冲突策略来兜底，不能只靠忽略。
开跑前先用小文件试一次，看预览区和前几行的落库结果，确认无误再上全量。

导入结束后打开统计/结果对话框，重点看成功、跳过、失败三个数字；失败大于 0 就点查看日志。
日志里每条异常都带位置信息，底层就是 DataTransferState.java 的loadErrors列表在逐条收集。找第一条错误按开头的对照表修复，后面的往往同源。
重跑之前，先决定上一轮已写入的数据回滚还是清理，否则旧的脏数据会让主键冲突二次出现。

组合一：先清洗再导入。源文件里混着空值、前导零、多种日期格式时，硬调导入设置是治标不治本。用 Excel 或文本编辑器统一格式后重跑，向导里的设置保持默认反而更稳。

适用场景	关键动作
源文件有脏格式、日期写法不统一	统一清洗后重新导入，别在映射页硬凑

组合二：删旧插新 + 分批。目标表里有大批历史数据，主键冲突成片出现时，不如先删掉与本次导入重叠的记录，再按几千行一批地跑，每批之间看一眼日志。

适用场景	关键动作
目标表存量数据多、冲突密集	先清冲突记录，分批导入并逐批核对

组合三：小批量试跑 + 日志回溯。几千行的文件一上来就全量跑，报错定位全靠猜。先切 20~50 行跑通，确认错误模式消失后再扩大范围，是导入日志查看效率最高的用法。

适用场景	关键动作
大文件跑全量后不知错在哪	截取小样本先跑，锁定错误模式再扩量

导入翻车不可怕，怕的是不看日志盲着重跑。现在打开 DBeaver，从"导入前"的分隔符和编码开始过一遍，报错先对照分类表归因，再动设置。如果排查完仍有疑问，docs/devel.txt 里有数据导入模块的结构说明，官方社区也可以直接提问。

【免费下载链接】dbeaverFree universal database tool and SQL client项目地址: https://gitcode.com/GitHub_Trending/db/dbeaver

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考