Oracle JDBC连接失败主因是驱动版本与JDK不匹配、URL格式错误（SID/服务名混淆）、SSL证书未信任及用户权限问题，需逐一核对驱动jar、JDK版本、URL语法、服务名、证书配置与账户状态。
Oracle JDBC驱动版本和DBeaver版本不匹配导致连接失败
常见错误现象是点击测试连接后报 java.lang.noclassdeffounderror: oracle/jdbc/oracledriver 或 classnotfoundexception，本质是 dbeaver 找不到驱动类。这不是 url 写错了，而是驱动压根没装对。
Oracle 官方从 21c 开始默认只提供 ojdbc11.jar（适配 JDK 11+），而很多老项目还在用 JDK 8 —— 这时必须手动下载 ojdbc8.jar，不能直接用最新版。
- DBeaver 23.3+ 默认内置
ojdbc11.jar，但仅限“新建 Oracle 连接”时自动加载；如果已有连接或驱动被手动删过，得自己补 - 去 Oracle 官网下载需先注册 Oracle 账号，搜 “Oracle Database 21c JDBC Driver” 或 “19c JDBC Driver”，别下错成 “ucp” 或 “xdb”
- 下载后在 DBeaver 中右键连接 → Edit Connection → Driver Settings → Download/Find Existing → 点
Add File选本地ojdbc8.jar或ojdbc11.jar
Oracle JDBC URL 格式写错：thin vs oci、服务名 vs SID
URL 写成 jdbc:oracle:thin:@localhost:1521:orcl 却连不上？大概率是最后那段用错了——orcl 是 SID，但现在 Oracle 默认用服务名（service name），比如 ORCLCDB.localdomain 或 XEPDB1。
查真实服务名最可靠的方式不是猜，而是登录数据库执行：SELECT value FROM v$parameter WHERE name = 'service_names';
- 标准 thin URL：
jdbc:oracle:thin:@//host:port/service_name（注意双斜杠，这是 12c+ 推荐格式） - 旧式 SID 格式（不推荐）：
jdbc:oracle:thin:@host:port:SID（三个冒号，最后是 SID 不是服务名） - 带 wallet 的连接（如 ATP）必须用
jdbc:oracle:thin:@wallet_location，且要额外配置oracle.net.wallet_location参数 - URL 中不能有空格、中文、特殊字符；端口确认是监听端口（通常是 1521），不是 HTTP 端口
DBeaver 连 Oracle 时提示 ORA-12650 或 SSL 握手失败
这通常发生在连接 Oracle Cloud ATP、ADB 或启用了 TLS 的本地库，DBeaver 默认不校验证书，但 Oracle 驱动强制要求信任链完整。
解决思路不是关 SSL，而是让驱动信任目标证书——要么把证书导入 JRE 的 cacerts，要么在 DBeaver 连接参数里指定信任库路径。
- 在连接编辑页点 Connection settings → Driver properties，加两行：
javax.net.ssl.trustStore=/path/to/your/truststore.jksjavax.net.ssl.trustStorePassword=changeit - 若用 Oracle Wallet，别只配 URL，还得加：
oracle.net.wallet_location=(SOURCE=(METHOD=file)(METHOD_DATA=(DIRECTORY=/path/to/wallet)) - ORA-12650 常伴随
no cipher suites in common，说明 JDK 版本太低（如 JDK 8u161 以下不支持 TLS 1.2），换 JDK 11+ 更省事
用户名密码输对了还是报 ORA-01017：账户被锁或认证方式不兼容
ORA-01017 表面是密码错，但 Oracle 12c+ 默认启用密码区分大小写 + 统一账户模型，DBeaver 如果没显式指定容器，可能连到 CDB 根而非 PDB。
比如你建的用户 scott 在 XEPDB1，但 DBeaver 默认连的是 CDB$ROOT，自然找不到该用户。
- 确保连接 URL 明确指向 PDB：用服务名，如
@//localhost:1521/XEPDB1，别用 SID - 检查用户是否被锁：
SELECT username, account_status FROM dba_users WHERE username = 'SCOTT';，状态是LOCKED就得 DBA 解锁 - Oracle 12c+ 默认关闭
SEC_CASE_SENSITIVE_LOGON，但某些安全策略会打开它；如果密码含大写字母却按小写输，也会报 ORA-01017 - 避免用
sys用户直连，除非勾选Connect as SYSDBA并在 Driver properties 里设internal_logon=sysdba
ojdbc11.jar 却用老式 SID URL，或者 URL 对了但 JDK 不支持服务名解析。这些地方没有报错提示，只有日志里一行模糊的“connection refused”，得靠手动比对驱动、JDK、URL、服务名四者是否真正对齐。
