SpringBoot+Maven打war包时同时打入本地jar包到lib目录下

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里加上对应的配置就可以了吧！这样的确是可以了，但这种方式不利于项目团队开发和工程源代码留存，并不能做到下载下来的工程代码直接就能编译运行的效果，所以考虑到代码的完整性，这个方案pass掉了。
        通过查阅一些相关资料，发现在中使用就可以做到引用第三方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连包里的内容都能显示：

本以为皆大欢喜了，然而在程序开发完毕，打包部署的时候出现了问题，发现引用的本地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包的时候不适用哦~