95%的Oracle JDBC不兼容问题源于版本错配：ojdbc10/11.jar误用于JDK 8环境（触发UnsupportedClassVersionError），或ojdbc8.jar连Oracle 11g时未禁用新认证协议（导致ORA-28040）；正确做法是依据Oracle官方验证矩阵匹配JDK、驱动与数据库版本组合。
95% 的“Oracle JDBC 驱动不兼容”问题，不是驱动本身写得不好，而是 ojdbc10.jar 或 ojdbc11.jar 被塞进了 JDK 8 环境，或者用 ojdbc8.jar 去连 Oracle 11g 却没关安全协商——根本矛盾从来不在“要不要升级”，而在“版本组合是否被 Oracle 官方验证过”。
怎么一眼识别是 JDK 与 ojdbc 版本错配？
看错误日志里有没有 java.lang.UnsupportedClassVersionError，尤其后半句带 has been compiled by a more recent version of the Java Runtime。这说明 JVM 拒绝加载类，不是驱动功能缺失，而是字节码版本超标。
-
ojdbc8.jar编译目标是 class file version 52（JDK 8），它能在 JDK 8/11/17/21 下正常加载 -
ojdbc10.jar最低要求 JDK 10（version 54），丢进 JDK 8 必炸 -
ojdbc11.jar最低要求 JDK 11（version 61），JDK 8 或 JDK 10 都跑不了 - 验证方式：用
javap -verbose oracle.jdbc.OracleDriver | grep "major version"查实际版本号
为什么 ojdbc8.jar 连 Oracle 11g 会报 ORA-28040？
这不是 JDK 问题，是协议层握手失败。ojdbc8.jar 默认启用 TLS 1.2+ 和新认证流程（auth_vfr_data），而 Oracle 11g R2（11.2.0.4）压根不支持该协商机制，连接时直接被监听器拒绝。
- 临时解法：在 JDBC URL 后加
?oracle.net.ssl_version=1.0&oracle.jdbc.thinLogonCapability=O5LOGON - 更稳做法：确认数据库补丁级别，11.2.0.4 之后的 PSU 可能已支持，否则应评估降级驱动（但
ojdbc6.jar在 JDK 8 下又会触发UnsupportedClassVersionError） - 别信“ojdbc8 兼容 11g”的模糊说法——Oracle 官方文档明确标注：11g 需配合
ojdbc6.jar+ JDK 6/7，或打满 PSU 后用ojdbc8.jar+ 显式禁用新协议
Maven 里怎么锁死正确版本并防冲突？
Spring Boot 项目最常因 spring-boot-starter-data-jpa 传递引入 ojdbc6.jar，导致 classpath 里同时存在两个版本，启动时报 LinkageError 或运行时 cannot be cast to java.sql.Connection。
- 声明官方坐标：
<groupId>com.oracle.database.jdbc</groupId>+<artifactId>ojdbc8</artifactId>，彻底弃用旧com.oracle.ojdbc:ojdbc8 - 排除传递依赖：
<exclusion><groupId>com.oracle.jdbc</groupId><artifactId>ojdbc6</artifactId></exclusion>加在 starter 依赖下 - 清理本地缓存：
rm -rf ~/.m2/repository/com/oracle/下所有非ojdbc8-*.jar目录 - IDE 内检查 External Libraries，确保只出现一个
ojdbc8-*.jar，且路径来自com.oracle.database.jdbc
OCI 库不匹配时为何连日志都不报错？
JDBC 驱动不会在初始化阶段主动校验 OCI 库，只有首次调用 OracleDataSource.getConnection() 或 OracleConnection.getImplicitConnection() 时才尝试加载 libclntsh.so（Linux）或 oci.dll（Windows）。所以你可能一路无报错，直到某个用了 FAN 或 AQ 的功能点突然崩掉。
- 强制打印加载路径：启动时加 JVM 参数
-Doracle.jdbc.Trace=true，搜日志里的oci library - 优先级顺序必须对：
java.library.path>LD_LIBRARY_PATH（Linux）或PATH（Windows）> 默认路径 - 若无法对齐 OCI 版本（比如服务器只装了 12c 客户端，但你用了
ojdbc11.jar），就显式禁用 OCI：oracle.jdbc.useOCILibrary=false，退化为 Thin 模式——但会损失 FAN、AQ、UCP 连接池等特性，性能下降 15%~30%
真正难处理的从来不是“找不到驱动”，而是驱动加载成功、连接也建立、SQL 看似执行了，结果批量插入返回全 0 更新计数，或 ResultSet.getObject() 对 TIMESTAMP WITH TIME ZONE 列直接抛 SQLFeatureNotSupportedException——这种静默不兼容，必须靠真实数据库版本 + 真实驱动版本 + 真实连接参数三者交叉验证，不能只查 Maven 仓库里哪个版本号更大。
