Maven生成可以直接运行的jar包的多种方式

最新推荐文章于 2026-04-01 04:04:31 发布
转载 最新推荐文章于 2026-04-01 04:04:31 发布 · 453 阅读 · 2 ·
本内容遵循CC 4.0 BY-SA版权协议
原文链接：https://blog.csdn.net/xiao__gui/article/details/47341385
本文介绍使用Maven的三种方法生成包含所有依赖且可直接运行的jar包：使用maven-jar-plugin和maven-dependency-plugin插件、maven-assembly-plugin插件以及maven-shade-plugin插件。每种方法的pom配置详细说明，解决SpringFramework冲突问题。

Maven可以使用mvn package指令对项目进行打包，如果使用java -jar xxx.jar执行运行jar文件，会出现如下错误：

  • "no main manifest attribute, in xxx.jar"（没有设置Main-Class）
  • ClassNotFoundException（找不到依赖包）等错误。

要想jar包能直接通过java -jar xxx.jar运行，需要满足：

  1. 在jar包中的META-INF/MANIFEST.MF中指定Main-Class，这样才能确定程序的入口在哪里；
  2. 要能加载到依赖包。

使用Maven有以下几种方法可以生成能直接运行的jar包，可以根据需要选择一种合适的方法。

方法一：使用maven-jar-plugin和maven-dependency-plugin插件打包

pom配置

<build>
	<plugins>
 
		<plugin>
			<groupId>org.apache.maven.plugins</groupId>
			<artifactId>maven-jar-plugin</artifactId>
			<version>2.6</version>
			<configuration>
				<archive>
					<manifest>
						<!-- 添加Class-Path配置项-->
						<addClasspath>true</addClasspath>

						<!-- 指定依赖包位置 -->
						<classpathPrefix>lib/</classpathPrefix>

						<!--指定Main-Class -->
						<mainClass>com.xxg.Main</mainClass>
					</manifest>
				</archive>
			</configuration>
		</plugin>
		<plugin>
			<groupId>org.apache.maven.plugins</groupId>
			<artifactId>maven-dependency-plugin</artifactId>
			<version>2.10</version>
			<executions>
				<execution>
					<id>copy-dependencies</id>
					<phase>package</phase>
					<goals>
						<goal>copy-dependencies</goal>
					</goals>
					<configuration>
						<!-- 将依赖的jar包，copy到 /lib 目录下 -->
						<outputDirectory>${project.build.directory}/lib</outputDirectory>
					</configuration>
				</execution>
			</executions>
		</plugin>
 
	</plugins>
</build>

MANIFEST.MF
maven-jar-plugin用于生成META-INF/MANIFEST.MF文件的部分内容.
下面是一个通过maven-jar-plugin插件生成的MANIFEST.MF文件片段：

Class-Path: lib/commons-logging-1.2.jar lib/commons-io-2.4.jar
Main-Class: com.xxg.Main

依赖jar
maven-dependency-plugin插件用于将依赖包拷贝到/lib目录下。
目录结构如下：
在这里插入图片描述

指定了 Main-Class，有了依赖包，那么就可以直接通过java -jar xxx.jar运行jar包。

这种方式生成jar包有个缺点，就是生成的jar包太多不便于管理，
下面两种方式只生成一个jar文件，包含项目本身的代码、资源以及所有的依赖包。

方法二：使用maven-assembly-plugin插件打包

pom配置

<build>
	<plugins>
 
		<plugin>
			<groupId>org.apache.maven.plugins</groupId>
			<artifactId>maven-assembly-plugin</artifactId>
			<version>2.5.5</version>
			<configuration>
				<archive>
					<manifest>
						<mainClass>com.xxg.Main</mainClass>
					</manifest>
				</archive>
				<descriptorRefs>
					<descriptorRef>jar-with-dependencies</descriptorRef>
				</descriptorRefs>
			</configuration>
		</plugin>
 
	</plugins>
</build>

使用命令：mvn package assembly:single 打包即可。
打包后会在target目录下生成一个xxx-jar-with-dependencies.jar文件，这个文件不但包含了自己项目中的代码和资源，还包含了所有依赖包的内容。
所以可以直接通过java -jar来运行。

此外还可以直接通过mvn package来打包，无需assembly:single，不过需要加上一些配置：

<build>
	<plugins>
 
		<plugin>
			<groupId>org.apache.maven.plugins</groupId>
			<artifactId>maven-assembly-plugin</artifactId>
			<version>2.5.5</version>
			<configuration>
				<archive>
					<manifest>
						<mainClass>com.xxg.Main</mainClass>
					</manifest>
				</archive>
				<descriptorRefs>
					<descriptorRef>jar-with-dependencies</descriptorRef>
				</descriptorRefs>
			</configuration>
			<executions>
				<execution>
					<id>make-assembly</id>
					<phase>package</phase>
					<goals>
						<goal>single</goal>
					</goals>
				</execution>
			</executions>
		</plugin>
 
	</plugins>
</build>

不过，如果项目中用到Spring Framework，用这种方式打出来的包运行时会出错，使用下面的方法三可以处理。

MAIN-添加任意key-value

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-assembly-plugin</artifactId>
    <version>2.5.5</version>
    <configuration>
      <archive>
        <!-- 添加任意 key-value -->
        <manifestEntries>
          <Premain-Class>xx.yy.zz.PermainAgent</Premain-Class>
        </manifestEntries>
      </archive>

    </configuration>
   
  </plugin>

方法三：使用maven-shade-plugin插件打包

pom配置

<build>
	<plugins>
 
		<plugin>
			<groupId>org.apache.maven.plugins</groupId>
			<artifactId>maven-shade-plugin</artifactId>
			<version>2.4.1</version>
			<executions>
				<execution>
					<phase>package</phase>
					<goals>
						<goal>shade</goal>
					</goals>
					<configuration>
						<transformers>
							<transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
								<mainClass>com.xxg.Main</mainClass>
							</transformer>
						</transformers>
					</configuration>
				</execution>
			</executions>
		</plugin>
 
	</plugins>
</build>

配置完成后，执行mvn package即可打包。
在target目录下会生成两个jar包，注意不是original-xxx.jar文件，而是另外一个。

如果项目中用到了Spring Framework，将依赖打到一个jar包中，运行时会出现读取XML schema文件出错。原因是Spring Framework的多个jar包中包含相同的文件spring.handlers和spring.schemas，如果生成一个jar包会互相覆盖。
为了避免互相影响，可以使用AppendingTransformer来对文件内容追加合并：

<build>
	<plugins>
 
		<plugin>
			<groupId>org.apache.maven.plugins</groupId>
			<artifactId>maven-shade-plugin</artifactId>
			<version>2.4.1</version>
			<executions>
				<execution>
					<phase>package</phase>
					<goals>
						<goal>shade</goal>
					</goals>
					<configuration>
						<transformers>
							<transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
								<mainClass>com.xxg.Main</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>
					</configuration>
				</execution>
			</executions>
		</plugin>
 
	</plugins>
</build>

···
maven生成可执行jar命令
08-17
maven项目发布生成可运行的jar文件，发布到服务器直接运行
Maven生成可以直接运行的jar包的三种方式
liuliang960的专栏
03-27 4452
最近学习使用jmeter写java测试代码，发现写的mvn工程代码里没有main方法，不知道如何打包，于是在网上发现了这篇文章，在本文的帮助下，将mainclass的标签注释掉，最终生产了测试jar包，通过了测试。 mainClass>com.xxg.MainmainClass--> 转载自：http://xxgblog.com/2015/08/07/maven-create-exec
maven项目创建可执行jar的6种方法
weixin_43784341的博客
03-25 2043
创建Java Maven项目的可执行JAR文件有多种方法，这些方法适用于任何Java项目，包括Spring和Spring Boot项目。
AMD锐龙笔记本装黑苹果避坑指南：VMware虚拟机安装macOS 15 Sequoia的5个关键优化
最新发布
weixin_33734785的博客
04-01 464
本文详细介绍了在AMD锐龙8845HS笔记本上通过VMware虚拟机安装macOS 15 Sequoia的5个关键优化步骤。针对780M核显性能调优、内存管理、CPU配置等核心问题，提供了一套完整的解决方案，帮助用户提升虚拟机运行macOS的流畅度和兼容性。
Maven 打包可运行jar包
【设计改变世界】github地址：https://github.com/guochunyang2004
09-28 1万+
Maven可以使用mvn package指令对项目进行打包，如果使用Java -jar xxx.jar执行运行jar文件，会出现"no main manifest attribute, in xxx.jar"（没有设置Main-Class）、ClassNotFoundException（找不到依赖包）等错误。要想jar包能直接通过java -jar xxx.jar运行，需要满足：1、在jar包中的META-INF/MANIFEST.MF中指定Main-Class，这样才能确定程序的入口在哪里；
Maven打包可执行jar包方法大全（史上最全）
热门推荐
weixin_49613823的博客
03-26 1万+
如果为true，则会在manifest文件中添加classpath，这样在启动的时候就不用再手动指定classpath了。打成的最终jar包中没有所依赖的jar包。如上面的manifest文件中，Class-Path的值中，每个jar包的前缀都是。后，会在target文件夹下生成两个jar包，一个是不带依赖的jar包，一个是后缀有。后，会在target文件夹下生成两个jar包，一个是不带依赖的jar包，一个是后缀有。本质上，这个配置的值是所依赖jar包所在的文件夹。可以将所有的东西都打包到一个jar包中。
java maven项目创建可执行jar的6种方法,可以用于任何JAVA项目包含spring, springboot项目
Tekin 是深耕技术 20 年的全栈实战派专家，精通 Go/Python/Java 等多语言开发。博客专注技术原理与实战结合，深度解析 Python 高阶编程、Go 语言架构、数据库优化等硬核内容。涵盖并发编程、机器学习、云原生等前沿领域，通过真实案例拆
03-21 2929
JAVA项目创建可运行的jar文件其实就是在jar文件中构建清单文件META-INF/MANIFEST.MF, 在这个前端文件中需要指定入口类 main-class, 还有打包相关的依赖项目等. 第6种方法依赖的额外包最少,文件也最小, 第五种方法生成的jar文件最大, 但是他启动的是一个tomcat服务,通常用于web项目的部署. 其他几种方法没有内置服务,适合于控制台应用的jar打包, Spring Boot Maven Plugin这个和springboot是无缝集成的,常用于springboot项
Maven插件学习（一）——生成可执行的 JAR 文件
螺旋小蜗的专栏
03-23 949
Maven生成可执行的 JAR 文件
storm学习之六-使用Maven 生成jar包多种方式
aodaidi6752的博客
12-29 276
Maven可以使用mvn package指令对项目进行打包，如果使用java -jar xxx.jar执行运行jar文件，会出现"no main manifest attribute, in xxx.jar"（没有设置Main-Class）、ClassNotFoundException（找不到依赖包）等错误。 要想jar包能直接通过java -jar xxx.jar运行，需要满足： ...
Maven打包可执行jar包
swimming_in_IT_的博客
12-07 1066
如上面的manifest文件中，Class-Path的值中，每个jar包的前缀都是libs/。配置正确了才能找到依赖。要运行该应用程序，只需在控制台中编写以下代码:java -jar target/webapp.jar，并通过在浏览器中指定localhost:8080/来测试它。：jar文件中的依赖项，您可以在每个可访问的位置运行它，打包工件的高级控制，从jar文件中排除依赖项等，以及打包war文件。提供了自定义类加载器，它知道如何从归档文件中的jar加载类和资源，而不是从文件系统中的jar加载。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值