将ojdbc8.jar添加到Eclipse/Maven项目的正确方法及报错解决

第一步：核对Maven安装参数与pom依赖的一致性 #

你之前将jar包安装到本地仓库的命令参数，必须和pom.xml里的依赖配置完全匹配，否则必然会报构件缺失：

• 先确认你pom.xml里的ojdbc8依赖配置，正确结构如下：

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

• 再核对你执行的安装命令，groupId、artifactId、version三个参数必须和上面的配置完全一致，正确命令参考：

mvn install:install-file -Dfile=你本地ojdbc8.jar的完整存储路径 -DgroupId=com.oracle.jdbc -DartifactId=ojdbc8 -Dversion=12.2.0.1 -Dpackaging=jar

注意：如果jar包存储路径包含空格，需要给路径加上英文双引号，避免命令识别错误。

第二步：对齐Eclipse与本地Maven的配置 #

Eclipse默认绑定了内置的Maven内核，哪怕你本地安装了Maven，没修改配置的情况下Eclipse用的不是你本地的Maven环境，仓库路径也会不一致：

• 打开Eclipse的「Window」→「Preferences」→「Maven」→「Installations」，勾选你自己安装的本地Maven，取消默认的Embedded Maven选项。
• 再进入「Maven」→「User Settings」，确认「User Settings」路径是你本地Maven的conf/settings.xml，「Local Repository」路径就是你刚才安装jar包的本地仓库路径，确认无误后点击「Update Settings」保存配置。

第三步：强制刷新项目Maven配置 #

配置对齐后右键你的项目→「Maven」→「Update Project」，勾选当前项目，同时勾选「Force Update of Snapshots/Releases」选项，点击确定等待刷新完成即可。

临时快速解决备用方案 #

如果不想调整配置，可以直接在pom中指定本地jar路径，无需安装到Maven仓库：

1. 在项目根目录新建lib文件夹，把ojdbc8.jar放入该文件夹
2. 把依赖修改为如下配置即可：

<dependency>
    <groupId>com.oracle.jdbc</groupId>
    <artifactId>ojdbc8</artifactId>
    <version>12.2.0.1</version>
    <scope>system</scope>
    <systemPath>${project.basedir}/lib/ojdbc8.jar</systemPath>
</dependency>

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