Maven项目打包时添加本地jar包

最新推荐文章于 2025-10-09 11:12:00 发布

转载最新推荐文章于 2025-10-09 11:12:00 发布 · 6.5k 阅读

23 ·

CC 4.0 BY-SA版权

原文链接：https://blog.youkuaiyun.com/m0_67391907/article/details/123986803

文章标签：

#maven #jar #java

文章介绍了两种在Maven项目中引入非Maven仓库的第三方jar包方法。方案一是通过`mvninstall:install-file`命令将jar包安装到本地仓库，然后在pom.xml中添加依赖。方案二是直接在pom.xml中以`system`作用域引入jar包，并配置maven-war-plugin或spring-boot-maven-plugin使其在打包时包含。这两种方法都能确保jar包在打包过程中被包含进war或jar文件。

Maven项目打包时添加本地jar包

maven打包时添加外部jar同maven中的jar包一起添加到编译后的文件当中

在开发项目时，有些 jar 包是非 maven 仓库提供的第三方 jar 包，比如七牛的 sdk，阿里的 sdk 等等。在项目开发时，有以下两个方案来引入、打包。

以alipay-sdk-java-3.0.0.jar这个 jar 包为例

方案一安装本地jar包到本地仓库

本地安装
在alipay-sdk-java-3.0.0.jar文件目录下执行命令，安装此 jar 包到本地 maven 仓库中

mvn install:install-file -Dfile=alipay-sdk-java-3.0.0.jar
-DgroupId=com.aliyun -DartifactId=alipay-sdk-java -Dversion=3.0.0 -Dpackaging=jar

2.普通方式导入jar包
在本地安装第三方 jar 后在项目 pom 文件中就可以像添加 maven 的 jar 包依赖一样

<dependency>
   <groupId>com.aliyun</groupId>
   <artifactId>alipay-sdk-java</artifactId>
   <version>3.0.0</version>
</dependency>

这个方案有个缺点，就是其他开发人员也必须在自己的电脑上执行步骤1的安装命令,安装 jar 包到自己本地仓库。

方案二在项目 pom 中配置
1.在项目根目录创建libs文件夹将使用的jar包放入其中
2.jar包以scope为system的方式导入pom文件

<dependency>
   <groupId>com.aliyun</groupId>
   <artifactId>alipay-sdk-java-3.0.0</artifactId>
   <version>3.0.0</version>
   <scope>system</scope>
   <systemPath>${project.basedir}/libs/alipay-sdk-java-3.0.0.jar</systemPath>
</dependency>

3.打包
3.1 打成 war包添加maven-war-plugin插件配置

<plugin>
   <groupId>org.apache.maven.plugins</groupId>
   <artifactId>maven-war-plugin</artifactId>
   <configuration>
      <webResources>
         <resource>
            <directory>${project.basedir}/libs</directory>
            <targetPath>WEB-INF/lib</targetPath>
            <includes>
               <include>**/*.jar</include>
            </includes>
         </resource>
      </webResources>
   </configuration>
</plugin>

3.2 打成 jar包

<plugin>
    <groupId>org.springframework.boot</groupId>
     <artifactId>spring-boot-maven-plugin</artifactId>
     <executions>
         <execution>
             <goals>
                 <goal>repackage</goal>
             </goals>
         </execution>
     </executions>
     <configuration>
         <includeSystemScope>true</includeSystemScope>
     </configuration>
 </plugin>