Java 8升级至Java 11时OracleDataSource编译报错求助

问题根源 #

Java 11 开始，javax.sql.DataSource 接口新增了 createConnectionBuilder() 方法，要求返回**java.sql.ConnectionBuilder**类型；但旧版本Oracle JDBC驱动中，oracle.jdbc.datasource.impl.OracleDataSource 实现的该方法返回自家的 OracleConnectionBuilderImpl，与Java 11标准接口的返回类型不兼容，直接触发编译冲突。

解决方案 #

1. 升级Oracle JDBC驱动版本 #

必须使用支持Java 11的Oracle JDBC驱动版本（推荐12.2.0.1及以上，官方优先推荐19c/21c版本适配Java 11）。在pom.xml中更新依赖：

<dependency>
    <groupId>com.oracle.database.jdbc</groupId>
    <artifactId>ojdbc8</artifactId>
    <version>19.3.0.0</version>
</dependency>

注意：若此前使用旧的com.oracle.jdbcgroupId，建议切换为官方新的com.oracle.database.jdbc坐标，这是Oracle Maven仓库的规范更新。

2. 清理Maven依赖缓存 #

执行命令彻底清理本地仓库中可能残留的旧版本驱动缓存：

mvn clean install -U

-U参数会强制Maven更新依赖版本，避免旧依赖干扰编译。

3. 排查并解决依赖冲突 #

用Maven依赖树命令检查是否有其他依赖引入了旧版本Oracle JDBC驱动：

mvn dependency:tree | grep oracle

若发现冲突，在对应依赖中排除旧版本驱动：

<dependency>
    <groupId>xxx</groupId>
    <artifactId>xxx</artifactId>
    <version>xxx</version>
    <exclusions>
        <exclusion>
            <groupId>com.oracle.jdbc</groupId>
            <artifactId>ojdbc6</artifactId>
        </exclusion>
    </exclusions>
</dependency>

4. 确认Maven编译器插件配置 #

确保maven-compiler-plugin指定正确的Java版本，避免编译时版本混淆：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.8.1</version>
    <configuration>
        <source>11</source>
        <target>11</target>
        <encoding>UTF-8</encoding>
    </configuration>
</plugin>

补充说明 #

你之前修改OracleDataSource的导入路径无法解决问题，核心矛盾是驱动版本不兼容Java 11的JDBC接口规范，而非导入包的选择。另外，项目中是否直接引用javax.sql.DataSource不影响编译检查，因为OracleDataSource本身实现了该接口，Java 11的接口变更会直接触发校验。

内容的提问来源于stack exchange，提问作者Tapialj