Spring Boot项目Maven打包外部引用的jar包问题

前言

        在项目开发有时需要引入一些在maven仓库中不存在的包，典型的就是Oracle驱动包, 一般做法就是在项目目录下新建一个lib文件夹， 然后把Oracel的驱动包放进去。然后右键文件夹， 选择 add as Library, 然后就可以正常使用外部jar包了。

 如下图所示：

         问题就是在maven Package打包之后，放在测试环境上启动就会报错， 显示无法加载到Oracle的驱动。

         其实问题也很简单， 是maven打包的问题，特此记录一下！

发现问题

        打开package结束之后的target目录下的jar， 就会发现， 在BOOT-INF->lib文件夹下，压根找不到 我们所需要的Oracle驱动包，所以就是maven没有把lib下的jar打包进去导致的。

正确使用外部Jar

一、加入lib, 然后add as library

        就像我上面所说，这样在编译器里就可以正常使用Jar包，启动成功了, 至此，只是在编译器能正常使用，想要通过java -jar 启动还是会报错，所以还需要另外一些配置，如下。

二、maven打包

        maven打包的时候，就需要在POM文件中加上jar的一些信息，以及在build标签配置资源文件路径了。

        <dependency>
            <groupId>com.oracle</groupId>
            <artifactId>ojdbc14</artifactId>
            <version>10.2.0.4.0</version>
            <scope>system</scope>
            <systemPath>${basedir}/lib/ojdbc14-10.2.0.4.0.jar</systemPath>
        </dependency>

        其中要注意的就是scope标签和systemPath标签。

maven中scope的默认值是compile

scope的分类

1）compile 默认是compile。compile表示被依赖项目需要参与当前项目的编译，包括后续的测试，运行周期也参与其中，是一个比较强的依赖。打包的时候通常需要包含进去。

2）test 表示依赖项目仅仅参与测试相关的工作，包括测试代码的编译，执行。比较典型的如junit

3）runtime 表示被依赖项目无需参与项目的编译，不过后期的测试和运行周期需要其参与。与compile相比，跳过编译而已。在终端的项目（非开源，企业内部系统）中，和compile区别不是很大。比较常见的如JSRXXX的实现，对应的API jar是compile，具体实现是runtime的，compile只需要知道接口就足够了。

4）procided 意味着打包的时候可以不用包进去，别的设施（web container）会提供。事实上该依赖理论上可以参与编译、测试、运行等周期。相当于compile，但是打包阶段做了exclude的动作。

5）system 和provide相同，不过被依赖项不会从maven仓库抓，而是从本地系统文件拿，一定要配合systemPath使用

 

        其次是build的配置， 需要在resources标签下指定资源文件的地址

    <build>
        <finalName>smpMonitor</finalName>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>

        <resources>
            <resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>**/*.xml</include>
                </includes>
                <filtering>true</filtering>
            </resource>
            <resource>
                <directory>${basedir}/src/main/resources</directory>
            </resource>

            <!--外部jar包地址-->
            <resource>
                <directory>${basedir}/lib</directory>
                <targetPath>BOOT-INF/lib/</targetPath>
                <includes>
                    <include>**/*.jar</include>
                </includes>
            </resource>
        </resources>

   </build>

         至此之后，项目打包就可以把外部的jar包也成功打包进去，在target文件夹也可以找到了，打包好的jar包内也存在引用的外部jar了。