Java 17环境下ojdbc11依赖冲突解决方法

在 Java 17 项目中，ojdbc11.jar 的依赖冲突常常让人头疼，但问题往往不是驱动本身有缺陷，而是模块系统（JPMS）和驱动声明之间没能对上号。具体来说，虽然 ojdbc11.jar 携带了 `module-info.java`，也声明了 `automatic-module-name: oracle.jdbc`，但它在 `requires` 声明上不够完整，反射访问也受限，再加上 classpath 中如果混入了旧版 ojdbc，就容易引发类加载器隔离，导致 `LinkageError` 或 `ClassCastException`。

ojdbc11.jar 为什么在 Java 17 下容易冲突？

根本原因不是驱动本身写得不好，而是 Java 17 默认启用了模块系统（JPMS），而 ojdbc11.jar 虽然携带了 `module-info.java`、声明了 `automatic-module-name: oracle.jdbc`，但它和 JDK 自身模块（比如 `java.xml.bind`）、其他依赖（比如 HikariCP、Spring Boot）之间存在加载时序与反射限制的双重夹击。常见表现是：`NoClassDefFoundError: javax/sql/DataSource`、`Module not found: oracle.jdbc`，或者连接池初始化时卡在 `DriverManager.getConnection()` 不抛异常也不返回。

module-info.java 中 requires oracle.jdbc 必须显式写

如果你的项目使用了模块化（即存在 `module-info.java`），光靠 Maven 引入 `ojdbc11` 是不够的——编译期就会报错 `Module not found: oracle.jdbc`；绕过编译强行运行，`DriverManager` 会因类加载器隔离找不到驱动类，最终抛 `SQLException: No suitable driver`。 - `requires java.sql;` 是基础，但必须额外加一行：`requires oracle.jdbc;` - 不要写 `requires transitive oracle.jdbc;` —— ojdbc11 不导出任何第三方模块，而且你的代码通常只用 `java.sql` 接口 - 如果项目非模块化（没有 `module-info.java`），这步可以跳过，但需要靠 JVM 参数来补位

--add-opens 和 --add-modules 缺一不可

ojdbc11 内部大量使用反射访问 `java.base` 和 `java.sql` 的私有字段（比如 socket 配置、SSL 上下文初始化），Java 17 默认禁止这种跨模块反射。HikariCP 尤其敏感，不加参数常卡在连接创建阶段，日志里既没错误也没成功记录。 - 必须添加：`--add-opens java.base/java.lang=ALL-UNNAMED` - 如果用了旧版 Spring Boot（比如 2.7.x）或依赖 `java.xml.bind`（比如某些 XML 解析逻辑），还得加：`--add-modules java.xml.bind` - 别用 `--add-modules ALL-SYSTEM` —— 过度开放会掩盖真实依赖问题，而且生产环境里可能被安全策略拦截

classpath 里混入多个 ojdbc.jar 是静默杀手

最隐蔽也最常被忽略：Tomcat 或 WebLogic 自带 `ojdbc6.jar` 或 `ojdbc7.jar`，而你的 WAR 包里又打了 `ojdbc11.jar`。类加载器可能从容器路径先加载旧版，导致 `OracleConnection` 类版本不一致，运行时报 `LinkageError` 或 `ClassCastException: oracle.jdbc.driver.T4CConnection cannot be cast to java.sql.Connection`。 - WebLogic：在 `WEB-INF/weblogic.xml` 中强制包级优先：`oracle.jdbc.*` - Tomcat：移走 `$CATALINA_HOME/lib/ojdbc*.jar`（重命名即可，别删），这是最干净的做法 - Maven 多模块项目：检查 `mvn dependency:tree | grep ojdbc`，确保只有一个 `ojdbc11` 出现在 compile/runtime scope 真正麻烦的从来不是“连不上”，而是“看起来连上了，但某天批量插入突然超时”或者“本地跑得通，上预发就偶发 ClassCastException”——这些基本都指向驱动加载路径或模块边界没理清。别迷信最新版，先查清数据库版本和 JDK 运行时约束，再决定是用 `ojdbc8` 还是 `ojdbc11`。