必须手动替换DBeaver自带OceanBase驱动（如mysql-connector-java-5.1.44），改用适配4.x+版本的驱动（如5.1.47+），同步更新驱动类名为com.alipay.oceanbase.jdbc.Driver、URL模板为jdbc:oceanbase://{host}:{port}/{database}，并按直连（端口2881，用户名@租户名）或OBProxy（端口2883，用户名@租户名#集群名）正确配置。
直接用 DBeaver 自带的 OceanBase 驱动连不上，不是配置错了，而是驱动本身不兼容当前 OceanBase 版本（尤其是 4.x 后），必须手动换驱动 + 改 URL 模板和类名。
连接失败时先确认是直连还是走 OBProxy
错误大多出在端口和用户名格式不匹配：
- 直连 OBServer：端口用
2881，用户名格式是用户名@租户名（例如root@mysql001） - 走 OBProxy（ODP）：端口用
2883，用户名格式是用户名@租户名#集群名或集群名:租户名:用户名 - 网络不通比配置错更常见——DBeaver 所在机器必须能
telnet $host 2881或telnet $host 2883通，否则直接报Connection refused或Network error
必须替换默认驱动并修改 Driver Settings
DBeaver 自带的 mysql-connector-java-5.1.44 在 OceanBase 4.2+ 上会握手失败，且类名和 URL 不匹配。不能只换 jar 包，还要同步改配置：
- 下载适配的驱动：推荐
mysql-connector-java-5.1.47或更高（5.1.49已验证可用），避免用 8.x 系列（不兼容 MySQL 5.6 协议） - 进
数据库 > 驱动管理器，搜索OceanBase，编辑它 - 在
库页签删掉默认驱动，点击添加文件加入新 jar - 切到
设置页签，把类名改成com.alipay.oceanbase.jdbc.Driver - 把
URL 模板改成jdbc:oceanbase://{host}:{port}[/{database}]（注意不是mysql://）
连上了却看不到 information_schema 和 mysql 库
这是 DBeaver 默认过滤系统库导致的，不是 OceanBase 问题：
- 右键已建立的连接 →
连接视图→ 勾选系统对象 - 点确定后会提示“连接已被更改”，此时必须手动右键该连接 →
刷新 - 如果仍不显示，检查用户是否有
SELECT权限访问information_schema（MySQL 租户下 root 默认有）
最易被忽略的是 URL 模板没改对——哪怕驱动换了、端口对了、用户名格式也对了，只要 URL 还是 jdbc:mysql://，就会静默降级走 MySQL 协议，然后在认证阶段卡死或返回空结果。
