1.前言

        SpringBoot和Maven的出现给我们的开发提供了很大的方便,正所谓事物都有两面性,有简便的地方就会有麻烦的地方,这里记录了一次使用Maven打包SpringBoot项目的时候出现的一个引用本地第三方jar包的问题。

2.问题描述

        一个SpringBoot项目,平时引用第三方jar包的时候,在pom文件里指定好该jar包的依赖就可以了,这本就是maven的一个很正常的操作,配置好依赖,maven自动将相应的jar包加入工程里,开发的时候就可以直接引入jar包内的类和方法,打包的时候maven还会将依赖的jar包打入到WEB-INF/lib下,皆大欢喜,多么开心~
        但总有那么个项目,由于一些列原因,必须要引入其他人提供给你的jar包,这些包是公有仓库上不存在的,如果有私服的还好,没有私服的就开始头疼了。
        有人说了,在本地maven仓库中新建目录,自定义一个路径把jar包放进去,然后在pom.xml里加上对应的<dependency>配置就可以了吧!这样的确是可以了,但这种方式不利于项目团队开发和工程源代码留存,并不能做到下载下来的工程代码直接就能编译运行的效果,所以考虑到代码的完整性,这个方案pass掉了。
        通过查阅一些相关资料,发现在<dependency>中使用<systemPath>就可以做到引用第三方jar包的效果,然后在spring-boot-maven-plugin中设置includeSystemScope为true就可以了,像下面这样:

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.st.springboot</groupId>
    <artifactId>ingredients-java</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>war</packaging>
    
    <name>ingredients-java</name>
    
	<dependencies>
		<dependency>
	        <groupId>org.bouncycastle</groupId>
	        <artifactId>bcprov-jdk16</artifactId>
	        <version>1.46</version>
	        <scope>system</scope>
	        <systemPath>${project.basedir}/src/main/resources/jar/bcprov-jdk16-1.46.jar</systemPath>
	    </dependency>
    </dependencies>
	<build>
		<plugins>
			<plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <includeSystemScope>true</includeSystemScope>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

设置完了非常开心,如果用的是idea,甚至还能看到IDE连包里的内容都能显示:

spring boot 引入 kingbase springboot引入lib包_jar


本以为皆大欢喜了,然而在程序开发完毕,打包部署的时候出现了问题,发现引用的本地jar包压根就打不进WEB-INF的lib目录下,jar包还在工程原来的位置放着了!

3.解决问题

        时间紧迫,先把所有引用的jar包往war包的lib目录下放进去吧,这么做确实好使,war包成功部署上去了。但一直这样不行啊,根本问题没有解决,万一有朝一日打算设置个maven定时自动打包部署什么的不就凉凉了……
        继续查阅资料寻找解决方法,终于功夫不负有心人,maven提供了插件专门解决打war包的时候引用本地包的问题,这东西叫做maven-war-plugin!
于是我的pom.xml变成了下面这样子:

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.st.springboot</groupId>
    <artifactId>ingredients-java</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>war</packaging>
    
    <name>ingredients-java</name>
    
	<dependencies>
		<dependency>
	        <groupId>org.bouncycastle</groupId>
	        <artifactId>bcprov-jdk16</artifactId>
	        <version>1.46</version>
	        <scope>system</scope>
	        <systemPath>${project.basedir}/src/main/resources/jar/bcprov-jdk16-1.46.jar</systemPath>
	    </dependency>
    </dependencies>
	<build>
		<plugins>
			<plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <includeSystemScope>true</includeSystemScope>
                </configuration>
            </plugin>
            <!-- 下面是为了将本地jar包打入WEB-INF/lib下而增加的配置-->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-war-plugin</artifactId>
                <version>3.2.2</version>
                <configuration>
                    <webResources>
                        <resource>
                        	<!-- 指向的是包含你所有要用jar包的目录 -->
                            <directory>${project.basedir}/src/main/resources/jar</directory> 
                            <!-- 编译后要把这些jar包复制到的位置 -->
                            <targetPath>WEB-INF/lib</targetPath>  
                        </resource>
                    </webResources>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

配置完后,再次运行package命令,发现本地的jar包完美的打进了WEB-INF/lib下,到此问题解决了!

另外还有个需要注意的地方,由于使用的是maven-war-plugin,因此打jar包的时候不适用哦~