DBeaver新建连接关键在驱动就位与参数匹配,漏掉任一环会导致“Connection refused”或“Driver not found”;需先确认驱动(如手动添加JAR)、再填参数,且修改驱动后须重启软件生效。

直接点:新建连接不是“填完就完”,关键在驱动是否就位、参数是否匹配目标数据库的实际部署方式——漏掉任一环,测试连接 就会卡在“Connection refused”或“Driver not found”。
点击哪里触发新建连接向导
启动 DBeaver 后,主界面左上角有显眼的 新建数据库连接 图标(带加号的数据库图标),或通过菜单栏 数据库 → 新建连接 打开。首次运行时弹出的 new_connection 窗口就是这个向导,但别急着填——先确认驱动。
MySQL/PostgreSQL 这类常见库,为什么点下一步后卡住或报错
常见现象是点击 下一步 后无响应,或提示 Driver not found。原因很实际:
- DBeaver 默认不预装 JDBC 驱动,哪怕你选了
MySQL,它也只是调用一个空壳驱动模板 - 首次连接时若网络畅通,会弹窗提示下载驱动;但若被防火墙拦截、代理未配置,或公司内网禁止外连,下载失败且无明确错误提示
- PostgreSQL 的默认端口是
5432,但某些 Docker 部署或云服务(如阿里云 RDS)可能映射到非标端口,填localhost:5432必然失败
解决办法:手动下载对应 JDBC 驱动 JAR 文件(如 mysql-connector-j-8.3.0.jar 或 postgresql-42.7.3.jar),在向导中点击 编辑驱动设置 → 库 标签页 → 添加文件 加入。
OceanBase、达梦、人大金仓这类国产库,必须手动建驱动
它们不在 DBeaver 内置驱动列表里,不能直接选。典型操作路径:
- 进
数据库 → 驱动管理器→ 点新建(或复制现有驱动如MySQL) - 填关键字段:
Driver Name自定义(如DmDriver),Class Name必须精确(如达梦是dm.jdbc.driver.DmDriver,OceanBase Oracle 模式是com.oceanbase.jdbc.Driver) -
URL Template要和官方文档一致(例如达梦是jdbc:dm://{host}:{port}/{database},端口默认5236;OceanBase 是jdbc:oceanbase://{host}:{port}/{database},端口默认2881) - 用户名格式易错:OceanBase 要写成
user@tenant,不是单纯user
测试连接成功但连不上具体库,问题常出在“数据库名”字段
这个字段对不同数据库意义不同:
- MySQL 中留空可连通,但后续看不到任何 schema;填了库名(如
test_db)才能直接展开该库下的表 - Oracle 和 OceanBase(Oracle 模式)中,该字段实际是
Service Name或Tenant Name,填错会导致认证通过但查不到对象 - PostgreSQL 中,它对应的是
database(即CREATE DATABASE xxx创建的那个名),不是集群名或实例名
最稳妥做法:先留空完成连接,连上后再右键已连接节点 → 新建数据库,再在新库下建表——避免早期参数混淆导致的权限或上下文错误。
真正容易被忽略的是:DBeaver 会缓存驱动加载状态,改完驱动配置后,必须重启软件才生效;另外,测试连接 成功只代表网络通、认证过、驱动能加载,不代表你有权限看 information_schema 或执行 SHOW DATABASES——权限不足时,连接框里一片空白,不是软件坏了,是账号太干净。











