如何在Maven仓库中添加Oracle JDBC驱动

在Maven项目中使用Oracle数据库时，由于Oracle JDBC驱动未托管在公共Maven中央仓库，需要手动将其添加到本地或私有Maven仓库，才能通过依赖配置正常引入。以下是具体的操作步骤和注意事项。

一、下载对应版本的Oracle JDBC驱动

首先需要根据你使用的JDK版本和Oracle数据库版本，下载匹配的JDBC驱动文件。常见的驱动文件名格式为ojdbcX.jar，其中X代表版本号，比如ojdbc8.jar对应JDK8及以上版本，适配Oracle 12c及更高版本。你可以从Oracle官方渠道获取对应版本的驱动，下载后记住文件存放路径。

二、手动安装驱动到本地Maven仓库

打开命令行工具，使用Maven的install:install-file命令将驱动文件安装到本地仓库。命令格式如下，需要根据实际下载的驱动信息替换对应参数：

mvn install:install-file -Dfile=驱动文件本地路径 -DgroupId=com.oracle.database.jdbc -DartifactId=ojdbcX -Dversion=驱动版本号 -Dpackaging=jar

参数说明：

• -Dfile：你下载的ojdbc jar文件的完整本地路径，比如D:/downloads/ojdbc8.jar
• -DgroupId：自定义的组织标识，通常设置为com.oracle.database.jdbc即可
• -DartifactId：项目标识，需要和驱动版本对应，比如ojdbc8
• -Dversion：驱动的版本号，比如21.9.0.0
• -Dpackaging：打包类型，填jar即可

执行命令后如果看到BUILD SUCCESS提示，说明驱动已经成功安装到本地Maven仓库中。

三、在pom.xml中添加依赖配置

驱动安装完成后，就可以在项目的pom.xml文件中添加对应的依赖，Maven会自动从本地仓库拉取该驱动。依赖配置需要和安装时设置的参数完全一致：

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

四、私有仓库场景的补充操作

如果是团队开发，使用私有Maven仓库（比如Nexus）的话，除了本地安装，还可以将驱动文件手动上传到私有仓库。上传后在pom.xml中配置私有仓库地址，就可以让团队所有成员都能拉取到该依赖，不需要每个人都手动安装到本地。

注意事项

1. 驱动版本要和JDK版本匹配，避免运行时出现兼容性问题。

2. 依赖的groupId、artifactId、version必须和安装时设置的信息完全一致，否则Maven会提示找不到依赖。

3. 如果需要切换驱动版本，重新执行安装命令更新版本信息后，同步更新pom.xml中的版本号即可。

4. 不要尝试在公共仓库搜索Oracle JDBC驱动下载，避免下载到被篡改的不安全文件，建议从官方可信渠道获取驱动。

MavenOracle_JDBC驱动本地仓库依赖配置pom.xml修改时间：2026-06-04 01:38:17