Navicat 连接 OceanBase MySQL 租户失败主因是参数配置错误:主机必须填 IPv4 地址(如 127.0.0.1)而非 localhost,端口默认为 2881;用户名格式为“用户名@租户名”;字符集须设 utf8mb4,初始化命令需包含 SET NAMES utf8mb4;、SET time_zone = '+00:00'; 和 SET SESSION ob_mysql_compatibility_mode = ON;;白名单必须包含客户端 IP。

Navicat 连接 OceanBase MySQL 租户失败,90% 是参数配错了——不是密码问题,也不是 Navicat 版本问题,而是几个关键字段必须严格按 OB 的协议逻辑填,错一个就卡在 Unknown database 'information_schema' 或 Connection refused。
主机和端口必须用 IPv4 地址 + 2881,不能填 localhost 或 2883
OceanBase 的 MySQL 协议只监听 IPv4 地址(如 127.0.0.1),不响应 localhost(它会解析成 ::1,即 IPv6);端口也必须是 MySQL 模式专用端口,默认 2881,不是 Oracle 模式的 2883,也不是云厂商改过的其他端口。
- 「主机」栏务必填
127.0.0.1(本地直连)或控制台明确给出的公网 IP / 域名(如t5******.aws-ap-southeast-1.oceanbase.cloud),不要填localhost - 「端口」以连接串中
-P参数为准,直连场景默认是2881;用 ODP(OceanBase Database Proxy)时才是2883,但此时用户名格式要变 - 如果填了
localhost或端口是2883却选了 MySQL 模式连接类型,Navicat 会连上 TCP 层但握手失败,报Connection refused或直接超时
用户名必须是「用户名@租户名」,且不能带集群名
直连 OceanBase MySQL 租户时,-u 参数只接受 用户名@租户名 格式,比如 root@mysql001。加集群名(如 root@mysql001#obcluster)会导致认证失败,报 Access denied。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 确认租户已激活:执行
SELECT * FROM oceanbase.__all_tenant WHERE tenant_name = 'mysql001';,status必须是ACTIVE - 云上实例注意:控制台「连接信息」里给的用户名就是最终格式,照抄即可,不要自行拼接
- 如果用的是 ODP 连接,用户名才需要写成
用户名@租户名#集群名或集群名:租户名:用户名,但 Navicat 连接类型仍选「MySQL」
字符集、时区、兼容模式三项必须手动设死
OceanBase MySQL 租户默认不暴露 information_schema,也不自动协商字符集与时区——Navicat 却默认查这个库、默认用 latin1 解析握手包、默认读本地时区。不硬性覆盖,就会出现表为空、中文乱码、时间偏移 8 小时。
- 「字符集」下拉框必须选
utf8mb4(不能留空,不能选auto) - 「高级」→「初始化命令」里粘贴两行:
SET NAMES utf8mb4;和SET time_zone = '+00:00'; - 为绕过
information_schema报错,同一栏再加一行:SET SESSION ob_mysql_compatibility_mode = ON;(临时会话级生效) - 长期方案:连上后执行
ALTER SYSTEM SET ob_mysql_compatibility_mode = ON;(需 SYS 权限)
白名单和网络通路比账号密码还优先
即使账号密码完全正确,只要客户端 IP 不在租户白名单里,OceanBase 会在 TCP 握手后立刻断开,Navicat 显示 Access denied 或直接无响应。
- 检查白名单:用
obclient连上后执行SHOW VARIABLES LIKE 'ob_tcp_invited_nodes';,确认返回值包含你的出口 IP(如123.45.67.89)或% - 云上实例:必须去控制台「连接」→「白名单」里添加你当前电脑的真实公网 IP(不是内网地址),可先加
0.0.0.0/0测试,验证后再收紧 - 本地部署:若只允许
127.0.0.1,那 Navicat 必须运行在同一台机器上;远程连接需显式修改白名单,例如:ALTER SYSTEM SET ob_tcp_invited_nodes = '123.45.67.89,192.168.1.0/24';
最易被忽略的一点:Navicat 的「测试连接」按钮只验证网络层和基础认证,不校验 information_schema 可见性、字符集是否生效、时区是否对齐。真正的问题往往出现在连接成功后展开数据库列表或执行查询的那一刻——所以初始化命令和字符集设置,缺一不可。

















