DBeaver导入SQL脚本时中文乱码如何解决？

Question

**问题描述（198字）：** 在使用DBeaver导入SQL脚本（如通过“执行SQL脚本”或“导入数据→从SQL文件”）时，若脚本中含中文注释、表名、字段值或INSERT语句中的中文内容，常出现乱码（显示为问号、方块或乱码字符），导致建表失败、数据写入异常或元数据不可读。该问题并非数据库本身编码错误（如MySQL已设utf8mb4），而是DBeaver客户端在读取SQL文件时未正确识别其字符编码。根本原因在于：DBeaver默认按系统Locale或UTF-8无BOM方式解析文件，而实际SQL文件可能以GBK、GB2312或UTF-8 with BOM保存；同时，连接配置中的“Client Encoding”与文件编码不一致，加剧解码失真。此问题高频发生于Windows环境下导出的Navicat/HeidiSQL脚本，或由国产编辑器保存的SQL文件，严重影响自动化部署与跨团队协作。

Answer 1

```html

一、现象层：乱码表征与典型错误场景

• SQL脚本执行时中文注释显示为“?”或“□”，如-- 创建用户表 → -- ?????
• CREATE TABLE语句中含中文表名（如CREATE TABLE `用户信息`）报错：ERROR 1103 (42000): Incorrect table name '??'
• INSERT语句中中文字段值写入后数据库中为问号（如INSERT INTO t VALUES ('张三') → 实际存入'??'）
• DBeaver控制台日志出现警告：Warning: Unable to decode file content using UTF-8. Trying system encoding...
• 同一SQL文件在VS Code/Notepad++中正常显示，但在DBeaver中导入即乱码——印证为客户端解析层问题

二、定位层：编码链路的三重解耦分析

问题本质是字符流在「文件存储→DBeaver读取→JDBC传输→数据库写入」四环节中至少两处发生编码失配。关键断点如下：

环节	默认行为	常见偏差源
SQL文件存储	Windows记事本默认GBK；Navicat导出常选GB2312；VS Code保存可选UTF-8 BOM	无BOM的UTF-8被误判为GBK；GBK文件被强制用UTF-8读取
DBeaver文件读取	v22.3+默认UTF-8（无BOM），旧版依赖系统Locale（Win下常为GBK）	未显式指定文件编码，BOM检测失败（如UTF-8 BOM被跳过）
JDBC连接参数	MySQL连接URL若缺useUnicode=true&characterEncoding=utf8mb4，驱动忽略Client Encoding设置	连接配置中“Client Encoding”设为utf8mb4，但URL未同步生效

三、验证层：快速诊断工作流（Mermaid流程图）

flowchart TD
  A[打开SQL文件] --> B{用Notepad++/VS Code查看编码}
  B -->|显示UTF-8-BOM| C[在DBeaver中右键SQL文件→Properties→Text File Encoding]
  B -->|显示GBK| D[检查DBeaver全局编码设置]
  C --> E[手动设为UTF-8 with BOM]
  D --> F[Window→Preferences→General→Workspace→Text file encoding]
  E --> G[执行脚本观察是否修复]
  F --> G
  G --> H{仍乱码？}
  H -->|是| I[检查数据库连接→Edit Connection→Driver Properties→clientEncoding]
  H -->|否| J[问题已定位]

四、根治层：五维协同解决方案

1. 文件级强制声明：用VS Code另存为「UTF-8 with BOM」格式，并在首行添加注释说明：-- encoding: UTF-8-BOM
2. DBeaver工作区级统一：Preferences → General → Workspace → Text file encoding → 选择UTF-8（勾选Override encoding from content）
3. 连接级精准对齐：编辑数据库连接 → Driver Properties → 添加键值对：clientEncoding=utf8mb4（MySQL）或currentSchema=public（PostgreSQL需额外设charSet=UTF-8）
4. JDBC URL硬编码兜底：在连接URL末尾追加：?useUnicode=true&characterEncoding=utf8mb4&serverTimezone=Asia/Shanghai
5. 自动化脚本预处理：Linux/macOS下用iconv批量转码：iconv -f GBK -t UTF-8 input.sql > output_utf8.sql；Windows可用PowerShell：Get-Content old.sql -Encoding Default | Set-Content new.sql -Encoding UTF8

五、工程实践：跨团队协作规范建议

• 在Git仓库根目录放置.editorconfig，强制SQL文件编码：[*.sql]\ncharset = utf-8-bom
• CI流水线中加入编码校验步骤：file -i *.sql | grep -v 'utf-8'，失败则阻断发布
• 向DBA/开发团队分发《SQL脚本编码白皮书》，明确：Navicat导出必须勾选「使用UTF-8编码」，HeidiSQL需在Export Settings中设置「Character set: utf8mb4」
• DBeaver模板化连接配置：导出连接配置XML，内置<property name="clientEncoding" value="utf8mb4"/>，新成员一键导入

```