Navicat连接OceanBase中文乱码是因客户端与服务端字符集未协商一致所致,需同步配置Navicat初始化命令(SET NAMES utf8mb4)、建表显式指定utf8mb4、导出选UTF-8 with BOM,并确认租户级字符集为utf8mb4_unicode_ci。
Navicat 连接 OceanBase 时显示问号或方块
这是典型的客户端与服务端字符集不一致导致的乱码,不是 navicat 或 oceanbase 单方面的问题,而是连接建立时未协商好编码。oceanbase 默认使用 utf8mb4,但 navicat 在建连时可能仍按 latin1 或旧版 utf8 解析响应流。
实操建议:
- 在 Navicat 新建连接的「高级」选项卡中,勾选
Use Unicode UTF-8 for filenames(Windows 下需开启,macOS/Linux 一般默认 OK) - 在「连接」→「高级」→「初始化命令」里填入:
SET NAMES utf8mb4;—— 这会强制本次会话使用utf8mb4 - 避免只设
SET CHARACTER SET utf8:OceanBase 的utf8是 MySQL 兼容层的别名,实际映射为utf8mb3,不支持 emoji 和部分中文生僻字
CREATE TABLE 语句执行后中文字段存成乱码
即使连接层正常,建表时若没显式指定字符集,OceanBase 可能沿用系统默认(如 utf8mb3),导致后续 INSERT 的中文被截断或转义失败。
实操建议:
- 建表必须显式声明字符集和排序规则:
CREATE TABLE t1 (name VARCHAR(64)) DEFAULT CHARSET = utf8mb4 COLLATE = utf8mb4_unicode_ci; - 不要依赖
SHOW VARIABLES LIKE 'character_set%'的返回值来推断建表行为——OceanBase 的变量作用域和 MySQL 不完全一致,尤其在租户级配置下 - 如果已存在乱码表,
ALTER TABLE ... CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci可能失败,需先导出数据,重建表,再导入
Navicat 查询结果中文正常,但导出 CSV 后全是乱码
导出动作脱离了数据库连接上下文,Navicat 默认用系统 locale 编码写文件(Windows 常是 GBK),而 Excel 打开时又按 UTF-8 解析,错位就出现乱码。
实操建议:
- 导出前在 Navicat「文件」→「导出向导」→「格式设置」中,将「编码」明确选为
UTF-8 with BOM(Windows 上 Excel 识别最稳) - 避免选
UTF-8无 BOM:Excel 会当成 ANSI 处理;也别选GBK,跨平台打开必然崩 - 如果导出的是 SQL 文件,注意 Navicat 生成的
INSERT语句里字符串是否带_utf8mb4前缀 —— 没有前缀的插入在目标库非 utf8mb4 时仍可能失败
OceanBase 租户级字符集配置影响 Navicat 行为
OceanBase 的字符集是租户(tenant)粒度的,不是实例级。一个集群里不同租户可以设不同 collation_server 和 character_set_client,Navicat 连哪个租户,就受哪个租户配置约束。
实操建议:
- 用管理员账号登录后,查当前租户配置:
SELECT * FROM oceanbase.__all_tenant WHERE tenant_name = 'your_tenant';,重点关注collation_type字段 - 修改租户字符集需用
ALTER TENANT ... SET VARIABLES,例如:ALTER TENANT your_tenant SET VARIABLES collation_server = 'utf8mb4_unicode_ci'; - 改完必须重启该租户的 session 连接(即 Navicat 断开重连),否则旧连接仍缓存原配置
字符集问题从来不是单点配置能解决的,从 Navicat 初始化命令、租户变量、建表 DDL 到导出编码,链条上任何一环掉链子都会让中文变问号。最容易被忽略的是租户级配置和导出编码这两个非连接层环节。










