maven打包jar包含依赖jar(spring项目,其余可参考)maven-shade-plugin

最新推荐文章于 2025-05-12 09:55:36 发布
最新推荐文章于 2025-05-12 09:55:36 发布
阅读量885 收藏 1
点赞数 1
CC 4.0 BY-SA版权
分类专栏： maven 文章标签： maven maven-shade-plugin mvn package
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/qq_32234865/article/details/79788639
本文介绍了如何使用maven-shade-plugin来打包包含依赖的jar，特别是解决Spring项目中由于多个依赖导致的NamespaceHandler找不到的问题。通过添加特定的transformer配置，将spring.handlers和spring.schemas文件append到jar包中，避免了BeanDefinitionParsingException错误。并提供了详细的maven-shade-plugin配置示例。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

一丶打包工具选择

  1. 网上说法比较多的有maven-shade-plugin和maven-assembly-plugin

  2. maven-assembly-plugin打包的很有可能出现:

    org.springframework.beans.factory.parsing.BeanDefinitionParsingException: 
Configuration problem: 
Unable to locate Spring NamespaceHandler for XML schema namespace 
[http://www.springframework.org/schema/aop]
Offending resource: ServletContext resource [/WEB-INF/webConfig.xml]Unable to locate Spring NamespaceHandler for XML schema namespace

    比较详细的解决方案是: https://www.cnblogs.com/icewee/articles/3703491.html，说是Spring的一个命名空间的名称空间处理程序没有找到，需要引入一些spring dependence,但是还是没有解决问题。后来在博客: https://blog.youkuaiyun.com/qing0706/article/details/51612040中找到了原因。原因如下：

    jar包下的META-INF目录下，有两个跟spring相关的文件：spring.handlers、spring.schemas，其中包含了打包后spring的一些东西，aop丶context等，如果在项目中对spring有多个依赖比如同时依赖aop，context，打包后仅仅会保存最后一个依赖。所以有时候是没有

    [http://www.springframework.org/schema/aop]

    ，有时候没

    [http://www.springframework.org/schema/context]

    需要加上一段配置如打包步骤2中transformer那个配置，这段配置意思是把spring.handlers和spring.schemas文件以append方式加入到构建的jar包中。但是配置了这个用assembly还是不好使，经过多次尝试失败后换了shade.

  3. 最后选用 maven-shade-plugin.

二丶打包步骤

探索了2天,终于打包成功,有可能步骤中有多余,但因为工作时间比较紧,成功了就没再尝试.

  1. pom文件中,导入插件依赖:

    <dependency>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.7.0</version>
</dependency>
​
<dependency>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>2.4.2</version>
</dependency>

    maven-shade-plugin尝试了3.0.0和3.0.1都提示有xxx类缺失问题,怀疑是和maven-compiler-plugin版本适配问题,但网上也没搜索到两者相关的版本号,于是我把shade降到了2.4.2可以正常打包.

  2. 添加插件maven-shade-plugin:

    <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>2.4.2 </version>
    <configuration>
        <!-- put your configurations here -->
    </configuration>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
            <configuration>  
               <transformers>  
                            <transformer  
                                implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">  
                                <!-- 如果有启动主类,此处可以具体填写该类地址,https://blog.youkuaiyun.com/h70614959/article/details/41697189 -->
                                <mainClass></mainClass>  
                            </transformer>  
                            <transformer  
                                implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">  
                                <resource>META-INF/spring.handlers</resource>  
                            </transformer>  
                            <transformer  
                                implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">  
                                <resource>META-INF/spring.schemas</resource>  
                            </transformer>  
                        </transformers>  
                <filters>  
                    <filter>  
                        <artifact>*:*</artifact>  
                        <excludes>  
                            <exclude>META-INF/*.SF</exclude>  
                            <exclude>META-INF/*.DSA</exclude>  
                            <exclude>META-INF/*.RSA</exclude>  
                        </excludes>  
                    </filter>  
                </filters> 
            </configuration>  
        </execution>
     </executions>
   </plugin>

    此处transformers如上assembly插件处。

    1. 添加maven-compiler-plugin插件:

     <plugin>
     <artifactId>maven-compiler-plugin</artifactId>
     <version>3.7.0</version>
     <configuration>
         <source>1.8</source>
         <target>1.8</target>
     </configuration>
</plugin>

    单独的使用maven-shade-plugin,eclipse里用maven update project的时候,会把项目jdk默认成1.5.终端使用mvn clean package 也会提示JDK版本的问题.所以用这个指定JDK版本.

三丶打包问题

  1. eclipse maven更新步骤:

    右击项目->maven->update project->勾上Force Update of Snapshots/Releases ,确认网络没有问题(小心自己的网代理),点击OK.

  2. 其余各种遇到的坑如上.下面附上最终的pom.xml完整版.

    <?xml version="1.0" encoding="UTF-8"?>
​
<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.littlersmall.rabbitmq-access</groupId>
    <artifactId>rabbitmq-access</artifactId>
    <version>1.0-SNAPSHOT</version>
    <dependencies>
   <dependency>  
        <groupId>org.springframework</groupId>  
        <artifactId>spring-core</artifactId>  
        <version>4.3.2.RELEASE</version>  
     </dependency>  
     
      <dependency>  
          <groupId>org.springframework</groupId>  
          <artifactId>spring-context</artifactId>  
          <version>4.3.2.RELEASE</version>  
      </dependency> 
       
      <dependency>  
          <groupId>org.springframework</groupId>  
          <artifactId>spring-tx</artifactId>  
          <version>4.3.2.RELEASE</version>  
      </dependency>  
        
       <dependency>  
           <groupId>org.springframework</groupId>  
           <artifactId>spring-aop</artifactId>  
           <version>4.3.2.RELEASE</version>  
       </dependency>  
        
        <dependency>  
            <groupId>org.springframework.security</groupId>  
            <artifactId>spring-security-core</artifactId>  
            <version>4.1.3.RELEASE</version>  
        </dependency>
          
        <dependency>  
            <groupId>org.springframework.security</groupId>  
            <artifactId>spring-security-taglibs</artifactId>  
            <version>4.1.3.RELEASE</version>  
        </dependency> 
         
        <dependency>  
            <groupId>org.springframework.security</groupId>  
            <artifactId>spring-security-config</artifactId>  
            <version>4.1.3.RELEASE</version>  
        </dependency>  
        
        <dependency>
            <groupId>aopalliance</groupId>
            <artifactId>aopalliance</artifactId>
            <version>1.0</version>
        </dependency> 
        
        <dependency>
            <groupId>org.aspectj</groupId>
            <artifactId>aspectjweaver</artifactId>
            <version>1.8.13</version>
            </dependency>
            
        <dependency>
            <groupId>org.springframework.data</groupId>
            <artifactId>spring-data-hadoop</artifactId>
            <version>2.5.0.RELEASE</version>
        </dependency>
        
    <dependency>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.7.0</version>
    </dependency>
​
    <dependency>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-shade-plugin</artifactId>
        <version>2.4.2</version>
    </dependency>
   </dependencies>
​
    <build>
        <!-- 打包后的jar名字 -->
        <finalName>rabbitmq</finalName>
    <resources>
      <resource>
        <directory>src/main/java</directory>
        <includes>
          <include>**/*.xml</include>
        </includes>
        <filtering>true</filtering>
      </resource>
      <resource>
        <directory>src/main/resources</directory>
        <includes>
          <include>**/*.*</include>
        </includes>
        <filtering>true</filtering>
      </resource>
    </resources>
    <outputDirectory>
            ${basedir}/src/main/webapp/WEB-INF/classes
    </outputDirectory>
    
     <plugins>
         <plugin>
              <artifactId>maven-compiler-plugin</artifactId>
              <version>3.7.0</version>
              <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
              </configuration>
          </plugin>
         <plugin>
             <groupId>org.apache.maven.plugins</groupId>
             <artifactId>maven-shade-plugin</artifactId>
             <version>2.4.2 </version>
             <configuration>
                <!-- put your configurations here -->
             </configuration>
             <executions>
                 <execution>
                     <phase>package</phase>
                     <goals>
                        <goal>shade</goal>
                     </goals>
                       <configuration>  
                        <transformers>  
                            <transformer  
                                implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">  
                                <!-- 如果有启动主类,此处可以具体填写该类地址,https://blog.youkuaiyun.com/h70614959/article/details/41697189 -->
                                <mainClass></mainClass>  
                            </transformer>  
                            <transformer  
                                implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">  
                                <resource>META-INF/spring.handlers</resource>  
                            </transformer>  
                            <transformer  
                                implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">  
                                <resource>META-INF/spring.schemas</resource>  
                            </transformer>  
                        </transformers>  
                         <filters>  
                            <filter>  
                              <artifact>*:*</artifact>  
                              <excludes>  
                                <exclude>META-INF/*.SF</exclude>  
                                <exclude>META-INF/*.DSA</exclude>  
                                <exclude>META-INF/*.RSA</exclude>  
                              </excludes>  
                            </filter>  
                          </filters> 
                    </configuration>  
                 </execution>
                 
             </executions>
         </plugin>
     </plugins>
    </build>
​
</project>
​


使用 maven-shade-plugin 打包你的 Maven 项目
一起coding，一起嗨。
10-10 1179
使用 maven-shade-plugin 打包你的 Maven 项目
idea+maven+maven-shade-plugin打包可执行jar
Don't lost way
08-29 1461
idea+maven+maven-shade-plugin打包可执行jar Maven打包可执行jar包，需要借助 maven-shade-plugin 插件。 添加插件 在pom文件中 节点下增加如下配置： <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-shade-plugin</artifactId>
spring-maven-jar包依赖
老痒的农舍
05-17 298
我的apache-maven版本是3.6.1，关于maven的环境配置可自行百度。 下面给出一组可用的jar包依赖： <dependencies> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId&g...
maven插件maven-shade-plugin打包jar文件使用详解
撸啊撸的博客
02-22 9429
在使用maven打包Java里，除了maven-jar-plugin和maven-assembly-plugin可以打包jar文件外，使用maven-shade-plugin也可以将程序打包成jar文件。maven-shade-plugin插件的功能也很强大，能够进行高度定制化jar的打包规则。在前面的插件介绍中，关于打包jar的插件我们已经介绍了2个，maven-jar-plugin和maven-assembly-plugin，包含今天介绍的，总共有3种方式来打包jar。
Maven 项目中将本地依赖库打包到最终的 JAR 中
最新发布
墨鸦的博客
05-12 1万+
在现代后端开发中，构建高效且可扩展的 Web 应用程序通常依赖于多种第三方库和内部依赖。这些依赖可以来自公共仓库，也可能是公司内部自研的库或尚未发布到公共仓库的 JAR 包。本文将详细介绍如何在 Maven 项目中处理本地依赖库，并确保这些依赖能够正确地打包到最终的可执行 JAR 文件中。本文不仅以 Doris 连接器（flink-doris-connector）作为示例，还涵盖了处理其他本地依赖库的通用方法。为什么需要打包本地依赖库？通常，依赖库可以通过 Maven 中央仓库或其他公共仓库轻松获取和管理。
Maven中Spring的jar包依赖关系
GuessHat的博客
09-07 296
Maven中Spring的jar包依赖关系 1.mvc 包含： aop beans core express context web 2.context 包含： aop beans core core beans core expression core 3.web 包含： core bean 4. test 包含： core 5. jdbc 包含： tx 6. tx 包含： beans core 7. 一个项目中应该导入配置的jar mvc jdbc mysql
使用maven-shade-plugin插件打包可运行jar
weixin_33981932的博客
11-03 205
2019独角兽企业重金招聘Python工程师标准>>> ...
通过maven-shade-plugin插件打可以独立运行的jar包
dong_19890208的专栏
04-28 652
通过maven-shade-plugin插件打可以独立运行的jar包
maven-shade-plugin-3.1.1.jar
02-26
java运行依赖jar包
maven-shade-plugin-3.1.0.jar
11-10
maven打包，指定入口类的jar包，具体的pom配置为：<plugin> <groupId>org.apache.maven.plugins <artifactId>maven-shade-plugin <version>3.1.0 <phase>package <goal>shade implementation=...
maven-shade-plugin-3.2.1.jar
02-26
java运行依赖jar包
用Maven打成可执行jar,包含maven依赖,本地依赖的操作
08-18
主要介绍了用Maven打成可执行jar,包含maven依赖,本地依赖的操作，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
借助springboot maven插件打包jar(含依赖jar)
学习笔记
04-13 963
借助springboot maven插件打包可执行jar <?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" ...
Spring Boot项目使用Maven打包并带上依赖
terence的博客
06-17 9082
在这篇博客中，介绍如何使用Maven将Spring Boot项目及其依赖项打包成一个可执行的jar文件。我们将使用Spring Boot的插件来完成这个任务。
利用maven-shade-plugin插件解决不兼容的JAR依赖冲突问题
weixin_43946565的博客
08-21 1279
在maven工程中，我们常常遇到底层依赖包的版本冲突问题。如果高版本对低版本兼容，那么我们可以使用maven的exclusions排除掉低版本。但如果版本互不兼容，甚至是不同jar有相同类名的冲突，就比较棘手了
Maven打包插件之——maven-jar-plugin、maven-assembly-plugin、maven-shade-plugin
calm_encode的博客
01-13 4001
1. 打包插件的介绍 打包插件是把class文件，配置文件打包成一个jar(war或者其他格式)的包。而且可执行jar包中包含或者不包含相应的依赖包包，当不包含相应的依赖包时，我们需要建立lib目录，且jar和lib目录在同级别目录。 2. 常见的打包插件 2.1maven-jar-plugin 可执行jar包与依赖包是分开的，需要建立li...
maven打包可执行的jar包-包含依赖jar
种一棵树最好的时间是十年前，其次是现在。
12-30 1万+
maven打包可执行的jar包：1. 首先确保编辑器里maven环境正常2. 运行打包的jar文件3. 测试添加依赖后打包。4. 注意cmd命令传入中文参数乱码 1. 首先确保编辑器里maven环境正常 我这里已经有现成的maven环境和工具类了，这里先使用myeclipse先测试一下maven打包，不包含任何依赖，只包含一个类，里面定义main函数。 public class TestJarApplication{ public static void main(String[] args) {
【Maven学习】Maven打包生成包含所有依赖的jar包
热门推荐
吃货小跟班的博客
01-06 7万+
maven打包生成的普通jar包，只包含该工程下源码编译结果，不包含依赖内容。同时，maven提供以下方式生成包含所有依赖的jar文件，依赖以class的方式存在； 将此plugin添加到pom文件中 <plugin> <artifactId>maven-assembly-plugin</artifactId>
maven打包插件maven-shade-plugin简单介绍
weixin_30642029的博客
01-30 373
作用： 1、可以把依赖打入jar包，然后直接使用这个jar包，从而不用担心依赖问题 2、通过设置MainClass，创建一个可以执行的jar包 3、Java工程经常会遇到第三方 Jar 包冲突，使用 maven shade plugin 可以解决 jar 或类的多版本冲突。 maven-shade-plugin 在打包时，可以将项目中依赖的 jar 包中的一些类文件打包到项目构建生成的 ja...
解决Java Jar包冲突的maven-shade-plugin插件指南
在聚合支付PC端项目中，正确配置maven-shade-plugin，可以确保所有依赖的加密库以及其他相关库的类文件能够和谐共存于同一个可执行jar中。这样做的好处是简化了部署过程，避免了运行时因类加载冲突导致的问题。 ...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

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

余额充值