DBeaver连接Oracle时中文乱码，如何正确设置字符集？

Question

DBeaver连接Oracle时出现中文乱码，根本原因通常是客户端字符集与数据库NLS_CHARACTERSET不一致，或JDBC驱动未正确传递编码参数。常见表现包括：查询结果、表注释、字段名显示为“??”或方块。解决需三步协同：①确认Oracle服务端字符集（`SELECT * FROM NLS_DATABASE_PARAMETERS WHERE PARAMETER = 'NLS_CHARACTERSET';`），常见为AL32UTF8或ZHS16GBK；②在DBeaver连接编辑页的「Driver properties」中显式添加`characterEncoding=UTF-8`（AL32UTF8库）或`characterEncoding=GBK`（ZHS16GBK库），并禁用自动检测；③确保DBeaver全局编码设为UTF-8（Windows → Preferences → General → Workspace → Text file encoding）。注意：Oracle JDBC驱动（ojdbc8+）默认支持UTF-8，但旧版驱动或错误配置会忽略服务端设置。切勿仅依赖系统环境变量（如NLS_LANG），DBeaver不读取该变量。验证方式：执行`SELECT '测试' FROM DUAL`，结果应正常显示。

Answer 1

```html

一、现象层：乱码的直观表现与初步定位

在DBeaver中执行SQL查询或浏览元数据时，中文字段名、注释、查询结果常显示为“??”、空方块（）、问号嵌套或乱序符号。典型场景包括：SELECT COMMENTS FROM ALL_TAB_COMMENTS WHERE TABLE_NAME = 'EMP'; 返回乱码；表结构视图中列注释不可读；新建表时输入中文注释保存后变为“????”。该现象并非DBeaver独有，而是JDBC客户端—Oracle服务端字符流解析断裂的外在表征。

二、协议层：字符编码传递链路的关键断点

Oracle字符集通信遵循三层协议栈：① 服务端NLS_CHARACTERSET（物理存储编码）→ ② JDBC驱动参数协商（characterEncoding、useUnicode等）→ ③ 客户端UI渲染（DBeaver JVM默认编码 + 编辑器工作区编码）。任一环节失配即导致字节流被错误解码。特别注意：ojdbc8+虽内置UTF-8兼容性，但若未显式设置characterEncoding，驱动将退化为依赖JVM默认编码（如Windows系统常为GBK），与AL32UTF8库产生1:1字节映射失败。

三、验证层：精准诊断服务端与客户端编码状态

检查项	SQL/路径	预期输出示例
数据库字符集	SELECT VALUE FROM NLS_DATABASE_PARAMETERS WHERE PARAMETER = 'NLS_CHARACTERSET';	AL32UTF8 或 ZHS16GBK
DBeaver JVM编码	Help → About DBeaver → Installation Details → View Error Log → 查看启动日志中file.encoding=UTF-8	必须为UTF-8（非系统默认）

四、配置层：三步协同式修复方案（实操级）

1. 服务端确认：运行SELECT * FROM NLS_DATABASE_PARAMETERS WHERE PARAMETER IN ('NLS_CHARACTERSET', 'NLS_NCHAR_CHARACTERSET');，明确主字符集类型；
2. 驱动参数强制注入：右键连接 → Edit Connection → Driver properties → 新增键值对：
   ▪ AL32UTF8库 → characterEncoding=UTF-8 + useUnicode=true
   ▪ ZHS16GBK库 → characterEncoding=GBK（禁用useUnicode）；
3. 全局工作区统一：Windows → Preferences → General → Workspace → Text file encoding → 选Other: UTF-8 → Apply and Close。

五、深度避坑：被低估的隐性陷阱与高阶对策

⚠️ NLS_LANG环境变量完全无效：DBeaver基于Eclipse RCP构建，其JVM不继承系统环境变量，设置NLS_LANG=AMERICAN_AMERICA.AL32UTF8无任何作用；
⚠️ ojdbc6及更早版本不支持UTF-8自动协商：必须升级至ojdbc8（12.2.0.1+）或ojdbc11，并在Driver properties中强制指定；
✅ 进阶验证法：执行SELECT DUMP('测试',1016) FROM DUAL;对比服务端原始字节（AL32UTF8应返回Typ=96 Len=4: c3,a7,c2,95）与DBeaver实际接收字节（通过日志启用org.jkiss.dbeaver.model.exec DEBUG级别捕获）。

六、流程图：乱码问题根因分析与解决路径

graph TD
  A[出现中文乱码] --> B{服务端NLS_CHARACTERSET?}
  B -->|AL32UTF8| C[Driver Properties设 characterEncoding=UTF-8]
  B -->|ZHS16GBK| D[Driver Properties设 characterEncoding=GBK]
  C --> E[Workspace Text Encoding = UTF-8]
  D --> E
  E --> F[验证 SELECT '测试' FROM DUAL]
  F -->|正常显示| G[闭环成功]
  F -->|仍乱码| H[检查ojdbc版本 & JVM file.encoding]

```