DBeaver连接Oracle失败主因是驱动未正确配置：需手动下载匹配JDK版本的ojdbc*.jar（JDK8用ojdbc8，JDK11/17用ojdbc11），在驱动管理器中指定并确认类名为oracle.jdbc.OracleDriver，URL用//格式（如jdbc:oracle:thin:@//host:port/service），禁用OCI模式。
驱动没配对，连测试按钮都点不动——这不是配置问题，是类加载器根本没看到 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）。必须手动加：
- 去 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 是否被解析成预期形式。很多“玄学失败”，其实日志里早有提示。
