DBeaver 不支持直接导入 Excel 文件,必须转为 CSV 或使用 xlSql 驱动;推荐先将 Excel 另存为 CSV UTF-8,注意文本格式、换行符处理及表头设置,再手动映射字段类型与列名。

DBeaver 本身不支持直接导入 .xlsx 或 .xls 文件,必须走中间格式或额外驱动 —— 这是所有报错和失败的根源。
为什么直接双击 Excel 文件会失败?
DBeaver 的「导入数据」右键菜单里没有 Excel 选项,点开只看到 CSV、SQL、JSON 等。这是因为 Excel 是二进制/复合格式(含样式、公式、多 sheet),DBeaver 默认 JDBC 驱动不解析它。你看到的“不支持此文件类型”或空预览,基本都卡在这一步。
常见错误现象包括:
Unsupported file type: .xlsx- 导入向导中预览为空或列全变成
NULL - 中文显示为问号或乱码(即使选了 UTF-8)
最稳的路径:Excel → CSV → DBeaver 导入
这不是妥协,而是绕过所有兼容性陷阱的实操标准流。关键不在“怎么点”,而在转换时守住三个细节:
- 在 Excel 中另存为时,必须选
CSV UTF-8 (逗号分隔) (*.csv),不是普通“CSV(逗号分隔)”——后者默认 ANSI 编码,Windows 环境下中文必乱 - 所有含前导零的字段(如工号
00123、身份证号),务必在 Excel 中先将整列设为「文本」格式,否则保存后变成123 - 如果 Excel 中有换行符或双引号,CSV 会自动用
"包裹字段,DBeaver 导入时需勾选「文本限定符」为",否则可能错列
想跳过 CSV?用 xlSql 驱动直连 Excel
适用于需要频繁读写 Excel、且不能改源文件格式的场景。但它不是开箱即用:
- 下载
xlsql-3.2.1.jar(注意版本,3.x 支持.xlsx,对.xls支持弱) - 在 DBeaver 的
驱动管理器中新建驱动,类名填com.xlsql.jdbc.Driver,URL 模板写jdbc:xlsql:file:{path_to_excel_file} - 新建连接时,URL 手动补全为类似
jdbc:xlsql:file:C:/data/report.xlsx,不能用浏览选择 - 首次连接可能报
Class not found: com.xlsql.jdbc.Driver—— 检查 jar 是否真被加载(驱动管理器里「库」标签页要有勾)
这个方式本质是把 Excel 当成只读数据库,INSERT 或 UPDATE 会失败,仅适合 SELECT 和验证逻辑。
别忽略表结构与字段映射这一步
即使 CSV 能预览成功,导入仍可能静默丢数据。原因常出在映射环节:
- DBeaver 导入向导第二步「表映射」里,不要依赖自动匹配 —— 中文列名和英文字段名不会自动对上,必须手动拖拽或下拉选择
- 日期列如果显示为
1970-01-01或NULL,检查 CSV 中该列是否含非标准格式(如2025年10月18日),需在「配置」页手动指定日期格式yyyy年MM月dd日 - 数值列导入后变科学计数(如
1.2345E+12),说明 DBeaver 推断成了浮点型,返回映射页点击该列,把目标类型改成BIGINT或VARCHAR
真正容易被忽略的是:CSV 第一行如果是中文标题,DBeaver 默认当表头;但如果 Excel 原始数据没标题行,却勾选了「第一行作为列名」,所有数据就会整体上移一行,首行被当字段名丢弃 —— 这种错几乎无法回溯。











