背景

开发的时用到的jar包可能在私服中找不到，需在下载到本地，然后在编译器Eclipse或者IDEA中引入本地jar包，这样在本地开发是OK的，但是linux服务器通过Maven打包的时候会提示异常找不到对应的类。这是需要在我们的pom.xml文件添加点配置了。

落地

开发支付宝沙箱支付时，需要引入本地jar包，我把jar存放的项目中的/src/main/resources/lib 下


1.打成war包引入本地jar

在build节点添加配置如下

<plugin>
	<groupId>org.apache.maven.plugins</groupId>
	<artifactId>maven-compiler-plugin</artifactId>
	<configuration>
			<source>1.8</source>
			<target>1.8</target>
			<encoding>UTF-8</encoding>
			<compilerArguments>
				<extdirs>${project.basedir}/src/main/resources/lib</extdirs>
			</compilerArguments>
	</configuration>
</plugin>


${project.basedir}：表示当前项目的路径，该变量不用配置赋值的；

/src/main/resources/lib ：表示我存放j本ar包的路径

2.SpringBoot打成jar包引入本地jar包

原文

后来的后来我把项目由Spring迁移到SpringBoot的时候，发现上传的配置并不能引入本地的jar包。pom文件的修改如下：

1.添加自定义的dependency

<!-- 引入本地jar包：支付宝模块 -->
<dependency>
	<groupId>com.alipay</groupId>
	<artifactId>com-alipay</artifactId>
	<version>1.0</version>
	<scope>system</scope>
          <systemPath>${project.basedir}/src/main/resources/lib/alipay-sdk-java20161213173952.jar</systemPath>
</dependency>
<dependency>
	<groupId>com.alipay.demo</groupId>
	<artifactId>com-alipay-demo</artifactId>
	<version>1.0</version>
	<scope>system</scope>
	<systemPath>${project.basedir}/src/main/resources/lib/alipay-trade-sdk-20161215.jar</systemPath>
</dependency>


 
scope：需要配置指定为system；

systemPath：指向jar包的地址；

groupId、artifactId、version：可以随意填写，其中artifactId+version就是maven打包后的jar包名

2.在build节点中的builds添加build

<plugin>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-maven-plugin</artifactId>
	<configuration>
		<includeSystemScope>true</includeSystemScope>
	</configuration>
</plugin>


maven打成的jar解压后，在BOOT-INF下的lib目录中可以找到配置引入的jar包。

SpringBoot Maven项目配置引入本地jar包及打包时包含本地jar
配置本地jar
<!--钉钉工具包,如缺失请到钉钉服务器开发文档下载 -->
		<dependency>
			<groupId>com.taobao.top</groupId>
			<artifactId>top-api-sdk-dev</artifactId>
			<version>ding-open-mc-SNAPSHOT</version>
			<scope>system</scope>
			<systemPath>${pom.basedir}/src/lib/taobao-sdk-java-auto_1479188381469-20200409.jar</systemPath>
		</dependency>

配置打包引用
plugin>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-maven-plugin</artifactId>
		<configuration>
			<includeSystemScope>true</includeSystemScope>
		</configuration>
</plugin>

为了解决maven依赖jar文件没有打包到部署包的问题，使用system

systemPath 获取jar包在项目中的存放路径如下图配置：



使用${project.basedir}动态获取项目根目录。

配置完成后点击clean，然后点击install即可打包成功，默认打成jar包，在项目target目录下。

项目场景：
项目中需要使用maven的打包工具，生成zip压缩包，使用的插件是assembly-plugin。因为一些特殊的原因，需要使用一些本地的jar进行依赖，加载外部jar后编码过程中没有任何问题，但是打包时一直报“程序包不存在”。
问题描述：
思考一下：Maven本质上是一个插件框架，它的核心并不执行任何具体的构建任务，所以虽然在开发过程中项目正常依赖没有任何问题，但是打包的时候肯定就找不到本地的jar了。
这种问题有很多解决方案，比如加入本地仓库、搭建maven私服等，如需这些解决方案自行谷歌百度，资料很多。
因为maven编译使用的插件是maven-compiler-plugin，所以只能在maven-compiler-plugin上找问题了，正常情况下的maven-compiler-plugin简单配置如下
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <configuration>
        <source>1.8</source>
        <target>1.8</target>
        <encoding>UTF-8</encoding>
    </configuration>
</plugin>

解决方案：
如果需要在打包的时候依赖本地jar，需要修改增加如下配置：
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <configuration>
        <source>1.8</source>
        <target>1.8</target>
        <encoding>UTF-8</encoding>
        <compilerArguments>
            <extdirs>${project.basedir}/src/lib</extdirs>
        </compilerArguments>
    </configuration>
</plugin>

如果使用的maven版本高于3.1，上述配置已被废弃，需要做如下修改：
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <configuration>
        <source>1.8</source>
        <target>1.8</target>
        <encoding>UTF-8</encoding>
        <compilerArgs> 
            <arg>-extdirs</arg> 
            <arg>${project.basedir}/src/lib</arg>
        </compilerArgs> 
    </configuration>
</plugin>

需要注意的是最好添加${project.basedir}以便有更好的兼容性。
修改上述编译插件后，打包正常，不再报错，但是有一个新的问题产生。生成的zip包并不包含依赖的本地jar。
修改maven-assembly-plugin插件的配置文件，增加如下配置：
<fileSet>      
    <directory>src\lib</directory>
    <outputDirectory>lib</outputDirectory>
</fileSet>


意思是把src\lib下的jar输出到target根目录lib下。

至此，使用maven的package命令，已能正常运行，并成功把本地jar包打入zip压缩包的lib目录下。