如何在DBeaver中配置Oracle JDBC驱动连接

落磊小哥_2231

落磊小哥_2231

2026-10-08

912人浏览

原创

dbeaver连接oracle失败主因是驱动未正确配置:需手动下载匹配jdk版本的ojdbc*.jar(jdk8用ojdbc8,jdk11/17用ojdbc11),在驱动管理器中指定并确认类名为oracle.jdbc.oracledriver,url用//格式(如jdbc:oracle:thin:@//host:port/service),禁用oci模式。

如何在dbeaver中配置oracle jdbc驱动连接

驱动没配对,连测试按钮都点不动——这不是配置问题,是类加载器根本没看到 OracleDriver 类。DBeaver 不自带 Oracle 驱动,必须手动指定匹配 JDK 版本的 ojdbc*.jar,否则 java.lang.ClassNotFoundException: oracle.jdbc.OracleDriver 或静默失败是必然结果。

确认 DBeaver 使用的 JDK 版本

DBeaver 启动时用的是哪个 JDK,决定了你该选哪个驱动。别猜,直接看:

  • Windows:右键 DBeaver 快捷方式 → 属性 → “目标”里找 -vm 参数指向的路径;没写就默认用系统 JAVA_HOME
  • macOS/Linux:终端执行 ps aux | grep dbeaver,找 -vm 或 -vmargs -Djava.home= 后面的路径
  • 常见组合:JDK 8 → 用 ojdbc8.jar;JDK 11/17 → 优先用 ojdbc11.jar(Oracle 21c+ 官方只维护这个)

错配后果很隐蔽:比如 JDK 17 加载 ojdbc8.jar,不会报错,但 DriverManager.getDrivers() 列表里压根没有 oracle.jdbc.OracleDriver,连接测试直接失败。

手动添加驱动文件,不是“下载”就完事

DBeaver 的“自动下载驱动”在国内基本不可靠,且容易下错版本(比如下成 ucp.jar 或 xdb.jar)。必须手动加:

QuantOracle
QuantOracle

63个确定性量化金融计算器 + 10个通过MCP的复合工作流。期权定价、Greeks、奇异衍生品、风险指标、投资组合优化……

下载
  • 去 Oracle 官网下载对应版本的完整 JDBC 包(搜 “Oracle Database 19c JDBC Driver” 或 “21c JDBC Driver”,需注册账号)
  • 解压后只取 ojdbc8.jar 或 ojdbc11.jar —— 其他如 ons.jar、oraclepki.jar 等,DBeaver 连接 Oracle 模式时不需要
  • 在 DBeaver 中:菜单栏 数据库 → 驱动管理器 → 找到 Oracle 驱动 → 编辑 → 库 → 添加文件 → 选中你下载的 ojdbc*.jar
  • 检查“类名”字段是否为 oracle.jdbc.OracleDriver(新版驱动有时会显示 oracle.jdbc.driver.OracleDriver,已弃用,得手动改成前者)

URL 格式写错,服务名和 SID 混用

填完驱动,测试仍报 ORA-12154 或 ORA-12505,大概率是 URL 语法或服务名不对:

  • 12c+ 推荐用双斜杠格式:jdbc:oracle:thin:@//localhost:1521/XEPDB1(注意 //,最后是服务名,不是 SID)
  • 老式三段格式:jdbc:oracle:thin:@localhost:1521:ORCL(三个冒号,最后是 SID,现在多数新实例不用这个)
  • 查真实服务名:登录数据库执行 SELECT value FROM v$parameter WHERE name = 'service_names';
  • 别从 tnsnames.ora 复制别名——那个是客户端解析用的,DBeaver 走的是直连,不读这个文件

连接测试前必须关掉 OCI 模式

OCI 是 Oracle 客户端本地库模式,依赖本地 ORACLE_HOME 和 oci.dll,DBeaver 在绝大多数场景下根本不支持,也不需要:

  • 新建连接时,类型选 “Oracle”,不是 “Oracle (OCI)”
  • 如果误选了 OCI,测试时会卡住或报 java.lang.UnsatisfiedLinkError
  • OCI 模式仅适用于极少数遗留环境(比如必须走 Oracle Wallet 且无法改 thin 连接),普通开发、测试、运维一律用 thin

真正容易被忽略的点:驱动加对了、URL 写对了、账号密码没错,但测试仍失败——先打开 DBeaver 日志(菜单 帮助 → 查看日志),搜索 OracleDriver 和 getConnection,看类是否被加载、URL 是否被解析成预期形式。很多“玄学失败”,其实日志里早有提示。

相关文章

驱动精灵
驱动精灵

驱动精灵基于驱动之家十余年的专业数据积累,驱动支持度高,已经为数亿用户解决了各种电脑驱动问题、系统故障,是目前有效的驱动软件,有需要的小伙伴快来保存下载体验吧!

下载

相关标签:

oracle

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

2023.10.12

4083

8

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.27

871

4

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

2024.02.23

1069

5

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

5961

10

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

2863

4

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

2024.04.07

5940

11

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

2024.04.29

7921

6

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

1070

5

sql中删除一列的命令是什么
sql中删除一列的命令是什么

在sql中,使用alter table语句可以删除一列,语法为:alter table table_name drop column column_name。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

932

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程