如何解决Java 8连接Oracle 19c失败

Java 8 连 Oracle 19c 失败主因是驱动、协议、URL 错配，需用 ojdbc8 驱动、service_name 格式 URL（如 @//host:port/SALESPDB）、服务端配置 SQLNET.ALLOWED_LOGON_VERSION_SERVER=12 并导入完整证书链。

Java 8 连 Oracle 19c 失败，90% 不是“连不上”，而是驱动、协议、URL 三者中至少一个没对上——尤其在生产环境，错配常表现为 ORA-12505、ORA-28040 或 SSLHandshakeException，而不是简单的超时或拒绝连接。

ojdbc8 必须用，且不能是 ojdbc6/ojdbc10

ojdbc6 缺少 OracleDriver.connect() 方法，ojdbc10 的字节码目标是 JDK 10+，JDK 8 加载直接报 ClassFormatError。只有 ojdbc8 同时满足：支持 Oracle 19c 新特性（如服务名注册、PDB 元数据）、兼容 JDK 8–11、无强依赖冲突。

1. 从 Maven Central 引入：com.oracle.database.jdbc:ojdbc8:19.21.0.0（别用 ojdbc8-full.jar，体积大、含调试符号）
2. 手动部署时，确认 oracle.jdbc.OracleDriver 类存在，不是已废弃的 oracle.jdbc.driver.OracleDriver
3. Spring Boot 2.3+ 中，spring.datasource.driver-class-name 必须设为 oracle.jdbc.OracleDriver，否则 HikariCP 初始化失败

JDBC URL 必须用 service_name，不能写 SID

Oracle 19c 默认多租户架构，PDB 没有 SID，监听器只注册 SERVICE_NAME。写成 jdbc:oracle:thin:@host:port:SALESPDB（冒号 + PDB 名）必报 ORA-12505。

1. 正确格式是斜杠开头：jdbc:oracle:thin:@//host:port/SALESPDB 或 jdbc:oracle:thin:@host:port/SALESPDB
2. 查真实服务名：在 CDB 中执行 SELECT name FROM v$services WHERE pdb = 'SALESPDB'，结果可能是 SALESPDB.example.com，URL 中应保留全称
3. tnsnames.ora 配置必须显式写 SERVICE_NAME = SALESPDB，不能只写 SID = SALESPDB

ORA-28040 或 handshake_failure？先看 SQLNET.ALLOWED_LOGON_VERSION 和 TLS 版本

ORA-28040 表面是“协议不匹配”，本质是客户端与服务端加密握手规则没谈拢；handshake_failure 则大概率是 TLS 协商失败，而非证书导入问题。

1. 服务端 sqlnet.ora 必须同时配置：SQLNET.ALLOWED_LOGON_VERSION_SERVER=12 和 SQLNET.ALLOWED_LOGON_VERSION_CLIENT=12（注意后缀），改完要 lsnrctl stop && lsnrctl start
2. JDBC URL 中加 ?oracle.net.ssl_version=TLSv1.2 强制协议，避免 JDK 8u31+ 默认禁用 TLSv1.0/v1.1 导致协商失败
3. 用 openssl s_client -connect host:1521 -tls1_2 实测服务端是否真支持 TLSv1.2——别信配置文档，得实连

证书链缺失比证书过期更常见

JVM 报 CertificateExpiredException 或 PKIX path building failed，往往不是服务器证书过期，而是中间 CA 证书没导入，或导入了但不在当前 JVM 的 cacerts 里。

1. 用 openssl s_client -connect host:1521 -showcerts 2>/dev/null | openssl x509 -noout -dates 抓完整链，逐段检查每张证书的 notAfter
2. 重点看中间 CA 证书——它有效期常比服务器证书短，2024–2025 年签发的很多已在 2026 年过期
3. 导入时用 keytool -importcert -file intermediate.crt -alias oracle-intermediate -keystore $JAVA_HOME/jre/lib/security/cacerts -storepass changeit，别只导服务器证书
4. 确认 Java 应用实际用的是哪个 JDK：ps aux | grep java 查 JAVA_HOME，别改错位置

真正卡住人的，从来不是单点问题，而是多个约束条件叠加：驱动版本对了但 URL 写错 format，URL 对了但服务端没开对应 service_name，service_name 对了但 TLS 协商被中间 CA 断掉——每一步都得实测验证，不能靠“应该可以”。