DBeaver导出Excel时中文乱码如何解决？

Question

在使用DBeaver导出数据库查询结果为Excel（.xlsx）文件时，部分用户遇到中文字符显示为乱码的问题。该问题通常出现在Windows系统中，尽管导出格式选择为UTF-8编码的CSV能正常显示中文，但导出为Excel时中文仍异常。可能原因为DBeaver导出Excel时未正确设置字符编码，或使用了不兼容的POI组件版本。此外，Microsoft Excel默认以本地编码打开文件，若未识别UTF-8 BOM，易导致中文乱码。如何配置DBeaver导出设置或调整Excel导入方式以正确显示中文，成为常见技术难题。

Answer 1

一、问题背景与现象描述

在使用DBeaver进行数据库查询结果导出时，许多用户反馈：当目标格式为Excel（.xlsx）文件时，中文字符在Microsoft Excel中打开后显示为乱码。该问题多发于Windows操作系统环境，尤其是在中文语言区域设置下尤为明显。

值得注意的是，若将相同数据导出为UTF-8编码的CSV文件，并通过Excel“数据导入”功能加载，中文可正常显示；这说明原始数据本身并无编码问题，问题出在导出机制与Excel解析行为的不匹配。

导出格式	编码方式	Excel直接打开	通过“获取数据”导入
.xlsx	内部由POI处理	乱码	正常
.csv (UTF-8)	BOM + UTF-8	部分乱码	正常

二、技术原理剖析：为何会出现乱码？

要理解该问题的根本原因，需从以下三个层面深入分析：

1. DBeaver导出引擎实现机制：DBeaver使用Apache POI库生成.xlsx文件。POI在写入字符串时，默认以Java内部Unicode表示存储，理论上支持所有字符集，但其序列化过程是否正确嵌入字体与编码元信息至关重要。
2. Excel对.xlsx文件的解析策略：不同于.csv文件依赖BOM判断编码，.xlsx是基于Office Open XML标准的压缩包结构，Excel依据[Content_Types].xml和sharedStrings.xml中的文本内容自动识别字符。若未显式声明编码或存在兼容性缺陷，则可能误判。
3. Windows系统区域与默认编码影响：尽管.xlsx应为Unicode原生支持，但在旧版Excel（如Excel 2016及更早）中，某些情况下仍会受系统ANSI代码页（如CP936）影响，导致非ASCII字符渲染异常。

三、常见误区与错误排查路径

很多开发者误以为这是“导出未选UTF-8”的问题，尝试修改导出设置中的“编码”，但实际上：

• DBeaver导出为.xlsx时，不提供手动选择字符编码的选项，因其由POI透明处理。
• 即使数据库连接已设置UTF-8，结果集传输正确，也不能保证导出组件完全保留语义。
• 用户常混淆.csv与.xlsx的编码处理逻辑——前者依赖BOM提示，后者依赖XML结构完整性。

典型错误操作包括：

# 错误思路：试图用记事本另存为带BOM的UTF-8解决.xlsx乱码
# 实际无效，因.xlsx非纯文本格式
notepad++ → 另存为 UTF-8 with BOM → .xlsx → 无改善
    

四、解决方案汇总与实施步骤

根据实际验证，有效的解决方案可分为客户端配置优化与外部导入流程调整两类：

方案1：升级DBeaver至最新稳定版

较新版本（v23.0+）已集成更新的Apache POI（≥5.2.3），修复了部分Unicode字符串写入bug。检查当前版本并升级：

Help → About DBeaver
→ 查看 Build Timestamp 或 Version Number
→ 前往 https://dbeaver.io/download/ 获取最新版
    

方案2：强制使用“导出向导”中的高级选项

在导出过程中启用“Use external exporter”或“Write cell formulas”等隐藏特性，间接触发更稳健的POI调用路径：

1. 右键查询结果 → Export Resultset
2. 选择“Microsoft Excel”格式
3. 进入“Settings”标签页
4. 勾选“Open document after export”
5. 取消勾选“Compress file”（测试用）
6. 点击“Next”完成导出

五、推荐的最佳实践流程图

为确保长期稳定导出中文内容，建议采用如下标准化流程：

graph TD A[执行SQL查询] --> B{结果含中文?} B -- 是 --> C[使用导出向导] B -- 否 --> D[常规导出.xlsx] C --> E[选择格式: Excel (.xlsx)] E --> F[检查DBeaver版本 ≥ v23.0] F --> G[确认JRE支持UTF-16] G --> H[导出时不压缩] H --> I[用Excel打开] I --> J{是否乱码?} J -- 是 --> K[改用“从数据获取”导入.xlsx] J -- 否 --> L[成功] K --> M[设置数据类型为文本] M --> N[完成刷新]

六、替代方案：绕过直接打开的限制

鉴于Excel直接双击打开.xlsx可能存在遗留解析缺陷，推荐使用Power Query（即“获取数据”）机制导入：

1. 启动Excel → 数据 tab → “从文件” → “从工作簿”
2. 选择导出的.xlsx文件
3. 在导航器中预览数据，确保中文清晰可见
4. 加载至工作表或数据模型

此方法利用现代Excel的数据连接引擎，能更准确地解析共享字符串表（Shared Strings Table），避免传统UI打开时的编码推断错误。

方法	兼容性	维护成本	适用场景
直接双击.xlsx	低（易乱码）	高	临时查看
Power Query导入	高	低	生产报表
导出为CSV+BOM	中	中	跨平台分发