Spring Boot+Spring Data集成Oracle JDBC驱动找不到oracle.jdbc.OracleDriver问题

我之前在整合Spring Boot和Oracle数据库时也碰到过一模一样的问题，结合你的配置信息，给你几个实用的排查和解决步骤：

1. 确认Oracle Maven仓库配置是否正确 #

Oracle JDBC驱动并不在Maven中央仓库，所以仅仅添加依赖还不够，必须在pom.xml中正确配置Oracle的官方仓库。你可以检查下是否已经添加了如下仓库配置：

<repositories>
    <repository>
        <id>maven.oracle.com</id>
        <name>Oracle Maven Repository</name>
        <url>https://maven.oracle.com</url>
        <layout>default</layout>
        <releases>
            <enabled>true</enabled>
        </releases>
        <snapshots>
            <enabled>false</enabled>
        </snapshots>
    </repository>
</repositories>

<pluginRepositories>
    <pluginRepository>
        <id>maven.oracle.com</id>
        <name>Oracle Maven Repository</name>
        <url>https://maven.oracle.com</url>
        <layout>default</layout>
        <releases>
            <enabled>true</enabled>
        </releases>
        <snapshots>
            <enabled>false</enabled>
        </snapshots>
    </pluginRepository>
</pluginRepositories>

另外，你需要在Maven的settings.xml中配置Oracle仓库的认证信息（如果还没配置的话），否则Maven无法正常下载驱动：

<servers>
    <server>
        <id>maven.oracle.com</id>
        <username>你的Oracle账号</username>
        <password>你的Oracle密码</password>
    </server>
</servers>

2. 验证依赖是否成功下载到本地仓库 #

手动检查本地Maven仓库路径（默认是~/.m2/repository/com/oracle/jdbc/ojdbc8/12.2.0.1），看看是否存在ojdbc8-12.2.0.1.jar文件。如果没有，执行以下命令强制更新依赖：

mvn clean install -U

3. 调整数据源配置（可选但有效） #

Spring Boot虽然能根据JDBC URL自动推断驱动类，但有时候自动识别会出问题。你可以在application.properties中显式指定驱动类：

spring.datasource.url=jdbc:oracle:thin:@localhost:1521:db1
spring.datasource.username=你的用户名
spring.datasource.password=你的密码
spring.datasource.driver-class-name=oracle.jdbc.OracleDriver

4. 同步IDE的依赖配置 #

如果你用的是IntelliJ IDEA或者Eclipse，有时候Maven下载了依赖但IDE没有同步。可以尝试：

• IntelliJ：点击Maven面板的「刷新」按钮（圆形箭头图标），或者执行File -> Reload All Maven Projects
• Eclipse：右键项目 -> Maven -> Update Project，勾选「Force Update of Snapshots/Releases」

5. 检查版本兼容性 #

确保你的Spring Boot版本和ojdbc8版本兼容。比如Spring Boot 2.x系列对ojdbc8的支持很好，但如果你的Spring Boot版本过低（比如1.x），可能需要降级JDBC驱动版本。另外，也可以尝试升级ojdbc8到更稳定的版本，比如19.3.0.0，修改pom.xml中的依赖：

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

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