如何在 Maven 项目中将本地依赖库打包到最终的 JAR 中

最新推荐文章于 2025-05-20 13:20:09 发布
最新推荐文章于 2025-05-20 13:20:09 发布
阅读量1.3k 收藏 7
点赞数 14
CC 4.0 BY-SA版权
文章标签： maven jar python
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/2401_89221867/article/details/144965496

前言

在现代后端开发中，构建高效且可扩展的 Web 应用程序通常依赖于多种第三方库和内部依赖。这些依赖可以来自公共仓库，也可能是公司内部自研的库或尚未发布到公共仓库的 JAR 包。本文将详细介绍如何在 Maven 项目中处理本地依赖库，并确保这些依赖能够正确地打包到最终的可执行 JAR 文件中。本文不仅以 Doris 连接器 (flink-doris-connector) 作为示例，还涵盖了处理其他本地依赖库的通用方法。

为什么需要打包本地依赖库？

通常，依赖库可以通过 Maven 中央仓库或其他公共仓库轻松获取和管理。然而，有时我们需要使用一些未发布到公共仓库的本地 JAR 包，例如：

  • 公司内部开发的库
  • 第三方提供但未上传到 Maven 仓库的库
  • 特殊版本或定制版的库

直接引用本地依赖库可能会引发一些问题，尤其是在构建和部署过程中。为了确保项目的可移植性和一致性，必须将这些本地依赖正确地打包到最终的 JAR 文件中。

常见问题

使用 system 作用域

在 Maven 中，可以使用 system 作用域来引用本地 JAR 包。然而，这种方法有几个显著的缺点：

  1. 不可移植性：system 作用域依赖的路径是硬编码的，其他开发人员在不同的环境中可能无法找到该路径。
  2. 打包问题：使用 system 作用域的依赖默认不会包含在最终打包的 JAR 文件中，导致运行时缺少必要的依赖。

依赖管理的最佳实践

为了避免上述问题，推荐的做法是将本地依赖库安装到 Maven 本地仓库中，并使用常规的依赖管理机制进行引用。这样，可以确保依赖库的一致性和可移植性，同时也方便后续的依赖管理和版本控制。

解决方案：将本地依赖库打包到最终 JAR

以下是详细的步骤，展示如何在 Maven 项目中包含本地依赖库并将其打包到最终的 JAR 文件中。

步骤 1：将本地 JAR 安装到 Maven 本地仓库

首先，需要将本地的 JAR 包安装到 Maven 的本地仓库中。假设我们有一个本地的 flink-doris-connector JAR 文件位于项目的 libs 目录下。

打开终端，执行以下命令：

 

bash
 

代码解读
 

复制代码
 

mvn install:install-file \ -DgroupId=org.apache.doris \ -DartifactId=flink-connector-doris_2.12 \ -Dversion=1.14_2.12-1.1.1 \ -Dpackaging=jar \ -Dfile=libs/flink-doris-connector-1.14_2.12-1.1.1.jar 
 

参数说明：

                

        

    

    
  


        

            

                      
                        最低0.47元/天 解锁文章
                        

                          
200万优质内容无限畅学

                          
                        

                      
            

        


    



                



	

		

			

				
					
SpringBoot踩坑记录：IDEA+MAVEN本地 jar 包打包及引入使用

				
			

			

				

					B_Hopkins的博客
				

				

					12-17
					
					1322
					
				

			

		

		

			
				
开场白
本文主要简单介绍下 IDEA + Spring boot + Maven 环境下的 本地 jar 包打包及使用姿势。
涉及的工程代码审核后会在文末附上。
我们首先搭一个简单的 Spring boot 工程， 仅有一个方法，给定半径计算圆的面积，代码结构如下：

其中Controller层提供一个接口，调用Service层计算圆的面积并返回：
@RestController
@RequestMapping("/test")
public class TestController {
    @Auto

			
		

	



                

            
              



	

		

			

				
					
将本地离线Jar包上传到Maven远程私库上，供项目编译使用

				
			

			

				

					Jarlen的专栏
				

				

					09-19
					
					607
					
				

			

		

		

			
				
因项目对接需求，需对接第三方Jar(海康人脸识别服务网关API)，在项目集成时，处于本地编译、远程持续构建的需要将离线Jar推送到远程Maven仓库。

			
		

	



              


  
              

                


	

		

			

				
					
Maven 项目中将本地依赖库打包到最终的 JAR 中

					
热门推荐

				
			

			

				

					墨鸦的博客
				

				

					05-12
					
					1万+
					
				

			

		

		

			
				
在现代后端开发中，构建高效且可扩展的 Web 应用程序通常依赖于多种第三方库和内部依赖。这些依赖可以来自公共仓库，也可能是公司内部自研的库或尚未发布到公共仓库的 JAR 包。本文将详细介绍如何在 Maven 项目中处理本地依赖库，并确保这些依赖能够正确地打包到最终的可执行 JAR 文件中。本文不仅以 Doris 连接器（flink-doris-connector）作为示例，还涵盖了处理其他本地依赖库的通用方法。为什么需要打包本地依赖库？通常，依赖库可以通过 Maven 中央仓库或其他公共仓库轻松获取和管理。

			
		

	





	

		

			

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

					
最新发布

				
			

			

				

					博客
				

				

					05-20
					
					1051
					
				

			

		

		

			
				
在Maven项目开发中，引入本地Jar包是常见需求，尤其是当依赖未发布到中央仓库或需要自定义版本时。本文详细介绍了如何通过Maven命令将本地Jar包安装到本地仓库，并在项目中正确引用。核心操作包括使用mvn install:install-file命令安装Jar包，指定文件路径、groupId、artifactId、version等参数，并在pom.xml中添加依赖配置。文章还提供了常见问题的解决方案，如路径错误、坐标冲突和环境变量配置问题，帮助开发者顺利完成本地Jar包的引入和使用。

			
		

	



		

			
		



	

		

			

				
					
Maven pom.xml 添加本地jar包依赖以及打包方法

				
			

			

				

					09-07
				

			

		

		

			
				
主要介绍了Maven pom.xml 添加本地jar包依赖以及打包方法，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧

			
		

	





	

		

			

				
					
maven打包本地依赖打进去

				
			

			

				

					dusked
				

				

					04-03
					
					2559
					
				

			

		

		

			
				
在 Maven 项目中，如果你需要包含本地的 jar 包依赖，并希望这些依赖在打包的时候被包含进去，可以通过以下方式解决这个问题，这是最推荐的方法，因为它符合 Maven 的依赖管理方式，并且可以确保这些依赖在打包时被正确处理。

			
		

	





	

		

			

				
					
maven如何依赖本地jar包

				
			

			

				

					qq_30908729的博客
				

				

					07-29
					
					938
					
				

			

		

		

			
				
maven如何依赖本地jar包?最简单方法在这里

解决方法：

例如pom.xml文件中想依赖本地包common-framework-0.0.1-SNAPSHOT.jar


答案：http://www.yayihouse.com/yayishuwu/chapter/1377...

			
		

	





	

		

			

				
					
Maven打包引入本地依赖包

				
			

			

				

					Dreams_KS的博客
				

				

					11-11
					
					1188
					
				

			

		

		

			
				
SpringBoot 工程，Maven 在构建项目时，如何引入本地 Jar 包？

			
		

	





	

		

			

				
					
maven工程怎么将除工程源码外的三方依赖一起打包到jar中

				
			

			

				

					keller的博客
				

				

					10-18
					
					4096
					
				

			

		

		

			
				
方法一和方法二都可以实现将代码打包成jar文件，通过比较我们发现方法二在代码量上更是好更简洁，生成的文件也更直观，不用特殊配置去掉后缀。总体来讲，两种方式都比较实用，针对个人情况，自行选择即可。翻了一下，spring boot maven plugin的源码，发现它的底层原来也是用maven-shade-plugin来实现的。其实估计大家也能猜到个大概，毕竟也就这么写主流的技术。

			
		

	





	

		

			

				
					
Maven项目中将依赖自动转换为Jar包的工具介绍

				
			

			

				

					
				

			

		

		

			
				
依赖管理是Maven的核心功能之一，它允许开发者声明项目所需的库，然后自动下载这些库到本地仓库。  #### pom.xml 文件的作用  pom.xml 文件是 Maven 项目的核心配置文件，它定义了项目的基本信息，如项目组 ID...

			
		

	





	

		

			

				
					
Springboot项目瘦身：将jar包与lib依赖分开打包

				
			

			

				

					weixin_46072377的博客
				

				

					01-15
					
					446
					
				

			

		

		

			
				
maven-jar-plugin 插件用于生成主 JAR 文件，并配置 MANIFEST.MF 文件中的相关信息；maven-shade-plugin 插件用于将一些特定的依赖项（例如 common 和 coo）打包到主 JAR 文件中，通常用于创建一个"uber JAR"（即包含所有依赖的 JAR）；因为maven-jar-plugin会生成一个无依赖的jar文件，所以不需要的情况下可以删除掉，maven-antrun-plugin 插件用于执行一些额外的任务，比如删除不需要的 JAR 文件。

			
		

	





	

		

			

				
					
用Maven打成可执行jar,包含maven依赖,本地依赖的操作

				
			

			

				

					08-18
				

			

		

		

			
				
主要介绍了用Maven打成可执行jar,包含maven依赖,本地依赖的操作，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧

			
		

	





	

		

			

				
					
maven项目打包[包含所有引入的依赖]

				
			

			

				

					breakout_alex的博客
				

				

					11-26
					
					1820
					
				

			

		

		

			
				
maven项目打包[包含所有引入的依赖] ： 将项目所有的文件，包括pom文件中依赖的jar包都打进一个jar包里面。



具体操作：

1.maven项目的pom文件添加配置：


<build>
  <plugins>
    <plugin>
      <artifactId>maven-assembly-plugin</art...

			
		

	





	

		

			

				
					
maven本地打jar包依赖

				
			

			

				

					m0_51236292的博客
				

				

					10-17
					
					560
					
				

			

		

		

			
				
中的地址配置成要打包jar的目标仓库地址。

			
		

	





	

		

			

				
					
maven项目打包 导入本地依赖并打包

				
			

			

				

					sunhaijingxiaohai的专栏
				

				

					08-25
					
					7671
					
				

			

		

		

			
				
打jar包

			
		

	





	

		

			

				
					
使用maven-assembly-plugin将 system 依赖范围的jar以class 方式打包进 jar包中

				
			

			

				

					我就是我不一样的美男子！
				

				

					06-06
					
					3896
					
				

			

		

		

			
				
服务A 有本地系统依赖（scope = system）如果服务A作为普通服务使用没有任何问题，但如果将服务A 以jar 包方式 提供给 服务B使用，那么服务B在编译的时候就有可能报错，因为找不到服务A 依赖的本地Jar。解决问题思路：将服务A依赖的本地Jar 以class 方式直接打包进输出jar包中，这样服务B在使用服务A时，就不会报找不到本地依赖的问题了；是否将跟目录打包到根目录中，因为我们是将三方jar包中的class 输出到jar中，所以不能有根目录；配置项，指定为本地依赖；防止依赖传递个服务B；

			
		

	





	

		

			

				
					
Maven打包本地jar的方法

				
			

			

				

					jerryyang_2017的博客
				

				

					10-19
					
					652
					
				

			

		

		

			
				
Maven打包本地jar的方法

			
		

	





	

		

			

				
					
【Maven技术专题】「入门到精通」教你如何使用Maven中引用依赖本地Jar包，并进行打包输出

				
			

			

				

					世界上并没有完美的程序，但是我们并不因此而沮丧，因为写程序就是一个不断追求完美的过程。
				

				

					12-12
					
					5872
					
				

			

		

		

			
				
Maven中，可用system范围和systemPath参数引用本地.jar文件，或使用命令安装到本地仓库。为了省去在新机器上安装的麻烦，需在pom.xml文件中声明元素指定本地仓库路径，以便Maven自动查找依赖。

			
		

	





	

		

			

				
					
idea使用maven插件将项目打包到本地仓库

				
			

			

				

					03-20
				

			

		

		

			
				
### 如何使用 Maven 插件在 IntelliJ IDEA 中将项目打包到本地仓库

#### 使用 `mvn install` 命令完成打包并安装到本地仓库
通过 Maven 的内置插件功能，可以轻松实现将 Java 项目打包为 JAR 文件并将该文件自动安装到本地 Maven 仓库中。此过程不需要额外配置 Artifacts 或手动操作。

执行以下命令即可完成上述目标：
```bash
mvn clean install -Dmaven.test.skip=true
```
这条命令的作用如下：
- `clean`: 清理之前的构建产物。
- `install`: 将项目打包并安装到本地 Maven 仓库。
- `-Dmaven.test.skip=true`: 跳过测试阶段以加快构建速度[^2]。

当运行以上命令时，Maven 会自动生成一个可运行的 JAR 文件，并将其存储于本地仓库路径（通常位于用户目录下的 `.m2/repository/`）。这样其他依赖该项目的模块可以直接通过 Maven 配置引用它。

#### 如果需要更复杂的场景处理
对于某些特殊需求，比如生成带有依赖项的 Fat Jar (即包含所有依赖类库的大包)，则需进一步调整 POM.xml 文件中的插件设置部分：

增加 Spring Boot 特定插件支持以便创建独立运行的应用程序实例：
```xml
<build>
    <plugins>
        <!-- Spring Boot Maven Plugin -->
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <executions>
                <execution>
                    <goals>
                        <goal>repackage</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>
```

此时再执行相同的 `mvn clean install` 流程将会得到一个适合直接部署使用的完整版本软件包[^3]。

另外值得注意的是，在实际开发过程中可能还会遇到一些特殊情况，例如希望把构建成果上传至远程私服(Nexus/Sonatype)而非仅仅局限于个人电脑上的私有空间，则应该按照官方文档指引补充必要的 `<distributionManagement>` 部分定义[^4]。

---

			
		

	



              




          




        



    





    



      

      

        
      

      





	

		评论	
	

  
	




  

    

      添加红包
      
    

    

      

        
        

          
          
        

        
请填写红包祝福语或标题

      

      

        
        

          
          个
        

        
红包个数最小为10个

      

      

        
        

          
          元
        

        
红包金额最低5元

      

      

        
        

          当前余额3.43元
          前往充值 >
        

      

      

        

          需支付：10.00元
        

        
        
      

    

  





  

    
    
  

  

    
    
  








  

    

      

        

          

            
            
成就一亿技术人!

          

          

        

        

          

          

            领取后你会自动成为博主和红包主的粉丝
            规则
          

        

      

      

        

          

            
              
            
            

              
hope_wisdom
 发出的红包
            

          

        

        

          

          

          

        

      

    

    

  



      
      

      
实付元

      
使用余额支付

      

        

          

            
            点击重新获取
          

        

        
扫码支付

      

      

        
          
            
          
          
        
      

      

        
        钱包余额
          0
          

            
            

              

                
抵扣说明：

                
 1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
 2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

              

            

          

      

      余额充值