DbVisualizer连接MySQL时中文显示乱码，如何设置编码？

Question

DbVisualizer连接MySQL时中文显示乱码，通常源于客户端与数据库间字符集不一致。常见原因包括：MySQL服务端默认编码为latin1、连接URL未指定UTF-8、DbVisualizer会话编码未同步、或表/列实际存储使用非UTF8MB4字符集。解决需四步协同：① 确认MySQL服务端`character_set_server=utf8mb4`且数据库/表已用`utf8mb4_unicode_ci`创建；② 在DbVisualizer连接配置的“Connection URL”末尾追加参数：`?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai`；③ 进入Tools → Options → Database → SQL Commander，将“Default encoding”设为UTF-8；④ 执行`SET NAMES utf8mb4;`验证当前会话编码。注意：仅修改DbVisualizer界面编码（如字体设置）无法解决数据层乱码，必须确保连接层、服务端、存储层全链路统一为UTF8MB4。

Answer 1

一、现象层：乱码的直观表现与典型场景

在DbVisualizer中执行SELECT name FROM user WHERE id = 1;时，中文字段显示为问号（?）、方框（□）或类似杮华的HTML实体转义字符；导入SQL脚本含中文注释时解析失败；导出CSV后Excel打开显示“李华”。此类现象非渲染故障，而是字节流在多环节解码失配所致。该问题在MySQL 5.7默认配置、Docker镜像未定制化、或历史遗留库迁移后高频复现。

二、链路层：字符集流转的四段式生命周期

MySQL中文支持本质是字节→字符的双向映射链路，共含四个关键节点：

层级	配置项/行为	典型错误值	影响范围
存储层	SHOW CREATE TABLE user; 中 CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci	latin1 / utf8（非utf8mb4）	已存数据永久损坏，ALTER需REPAIR
服务端层	SHOW VARIABLES LIKE 'character_set%'; 中 character_set_server	latin1 / utf8	新建库/表默认编码错误
连接层	JDBC URL参数 & 驱动握手协商	缺失 useUnicode=true&characterEncoding=UTF-8	实时查询/插入全链路乱码
客户端层	DbVisualizer SQL Commander编码 + JDBC会话变量	Default encoding=ISO-8859-1	仅当前会话查询结果异常

三、诊断层：分阶段验证工具链

执行以下命令组合可精准定位断点：

1. SELECT @@character_set_server, @@collation_server;
2. SHOW CREATE DATABASE mydb;
3. SHOW VARIABLES LIKE 'collation_database';
4. 在DbVisualizer中执行：SELECT CHARSET(VERSION()), COLLATION(VERSION());
5. 运行 SET NAMES utf8mb4; 后再查中文字段，观察是否修复

四、根治层：四步协同配置法（含生产级验证）

必须同步完成以下四项，缺一不可：

1. 服务端固化：修改my.cnf，在[mysqld]下添加
   character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
   重启MySQL并验证SHOW VARIABLES LIKE 'character_set_server';返回utf8mb4
2. 连接URL强化：DbVisualizer连接配置中，JDBC URL末尾追加
   ?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true&useSSL=false
   （MySQL 8.0+需额外添加allowPublicKeyRetrieval）
3. 客户端编码对齐：菜单栏Tools → Options → Database → SQL Commander → Default encoding设为UTF-8；同时检查Tools → Options → General → Fonts中UI字体是否支持CJK（如Noto Sans CJK SC）
4. 会话级即时生效：新建连接后，在SQL Commander中执行
   SET NAMES utf8mb4;
SET CHARACTER SET utf8mb4;
   随后验证：SELECT @@character_set_client, @@character_set_results, @@character_set_connection; 全部应为utf8mb4

五、加固层：全链路一致性校验流程图

下图为生产环境部署前必跑的字符集健康检查流程：

┌─────────────────┐    ┌───────────────────────┐    ┌─────────────────────────┐
│ MySQL配置文件   │───▶│ 服务端变量初始化      │───▶│ 数据库/表实际字符集     │
│ my.cnf          │    │ character_set_server  │    │ SHOW CREATE DATABASE/TABLE│
└────────┬────────┘    └───────────────────────┘    └─────────────────────────┘
         │                            │                           │
         ▼                            ▼                           ▼
┌───────────────────────────────────────────────────────────────────────────┐
│                     DbVisualizer连接URL参数校验                           │
│ ?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai     │
└───────────────────────────────────────────────────────────────────────────┘
         │
         ▼
┌───────────────────────────────────────────────────────────────────────────┐
│                SQL Commander Default encoding = UTF-8                     │
└───────────────────────────────────────────────────────────────────────────┘
         │
         ▼
┌───────────────────────────────────────────────────────────────────────────┐
│               运行 SET NAMES utf8mb4; 并验证三变量一致性                 │
│ @@character_set_client == @@character_set_results == @@character_set_connection │
└───────────────────────────────────────────────────────────────────────────┘

六、避坑层：高阶陷阱与兼容性说明

① utf8 ≠ utf8mb4：MySQL的utf8实为阉割版（最大3字节），无法存储emoji及部分生僻汉字（如「𠜎」「𠮷」），必须用utf8mb4；② Docker场景需挂载自定义my.cnf，官方镜像默认仍为latin1；③ 若表已用latin1创建，执行ALTER TABLE t CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;时须先备份，因转换过程可能截断超长索引；④ DbVisualizer 12.0.10+版本支持自动注入SET NAMES，但旧版本仍需手动执行。