在Java项目中使用Maven管理依赖时,Oracle的JDBC驱动包因为许可证原因没有托管在Maven中央仓库,直接通过dependency标签引入会提示依赖找不到,需要手动将驱动包添加到Maven仓库中才能正常使用。

方法一:手动安装驱动到本地Maven仓库
这是最常用的方式,适合个人开发或者小团队场景,步骤如下:
1. 下载对应版本的Oracle驱动包
首先需要根据你使用的Oracle数据库版本,下载对应的ojdbc驱动,比如Oracle 11g对应ojdbc6.jar,Oracle 12c对应ojdbc8.jar,注意驱动版本要和数据库版本兼容,避免后续连接出现兼容性问题。
2. 执行Maven安装命令
打开命令行工具,进入驱动包所在的目录,执行以下Maven命令将驱动安装到本地仓库:
mvn install:install-file -Dfile=ojdbc8.jar -DgroupId=com.oracle.database.jdbc -DartifactId=ojdbc8 -Dversion=12.2.0.1 -Dpackaging=jar
命令参数说明:
- -Dfile:指定你下载的驱动包文件名,如果不在当前目录需要写完整路径
- -DgroupId:自定义驱动包的组ID,建议按照Oracle官方推荐的格式填写
- -DartifactId:自定义驱动包的项目ID,通常和驱动文件名对应
- -Dversion:自定义驱动包的版本号,建议和驱动本身的版本一致方便管理
- -Dpackaging:指定打包类型,驱动包是jar格式所以填jar
3. 在pom文件中添加依赖
安装完成后,就可以在项目的pom.xml文件中添加对应的依赖配置了:
<dependency>
<groupId>com.oracle.database.jdbc</groupId>
<artifactId>ojdbc8</artifactId>
<version>12.2.0.1</version>
</dependency>方法二:配置私有仓库托管驱动包
如果是团队开发场景,手动给每个开发者的本地仓库安装驱动效率很低,可以搭建私有Maven仓库(比如Nexus),将Oracle驱动包上传到私有仓库中,然后让团队所有项目都从私有仓库拉取依赖。
上传完成后,在项目的pom.xml中配置私有仓库地址,再添加对应的dependency即可,依赖配置和本地安装的方式一致,只是仓库来源变成了私有仓库。
常见问题解答
安装命令执行报错怎么办
首先检查是否配置了Maven环境变量,命令行输入mvn -v能正常显示版本信息才说明Maven环境可用。其次检查驱动包路径是否正确,文件名是否和-Dfile参数一致,避免因为路径错误导致安装失败。
驱动版本和数据库版本不匹配会有什么影响
可能会出现数据库连接失败、SQL执行报错、数据类型转换异常等问题,建议先确认自己使用的Oracle数据库版本,再选择对应的驱动包,比如Oracle 19c可以选择ojdbc10.jar或者ojdbc8.jar,具体可以参考Oracle官方驱动版本说明。
如何确认驱动是否安装成功
可以打开本地Maven仓库目录(默认是用户目录下的.m2/repository),按照你设置的groupId路径查找,比如上面示例的路径是com/oracle/database/jdbc/ojdbc8/12.2.0.1,如果该目录下有ojdbc8-12.2.0.1.jar文件,说明安装成功。
MavenOracle驱动包本地仓库dependencyojdbc修改时间:2026-06-04 01:41:32