jar运行报错no main manifest attribute原因分析及解决

更新时间：2026年04月14日 15:15:53 作者：西凉的悲伤

文章主要讨论了在使用`java -jar`命令运行jar包时遇到的“nomainmanifestattribute”错误,并提供了可能的解决方案,包括检查pom.xml配置,添加打包插件配置,以及使用IDEA进行打包等方法

jar运行报错no main manifest attribute

在服务器上运行：

java -jar test-0.0.1-SNAPSHOT.jar

报错：

no main manifest attribute, in test-0.0.1-SNAPSHOT.jar

原因

原因是找不到主类。

一般情况下，java 打包成 jar 包需要在 MANIFEST.MF 中指定 Main-Class项，以便运行 java -jar xxx.jar 时找到对应的主类。

将test-0.0.1-SNAPSHOT.jar解压后

查看META-INF下的MANIFEST.MF

而正常的应该是这样的：

解决

1.检查 maven 项目中的 pom.xml 中有没有缺少如下配置，缺少的话加上

<packaging>jar</packaging>

2.在 pom.xml 中的 build 标签下的 plugins 标签下加入如下打包插件配置

            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <version>2.6.0</version>
                <configuration>
                    <mainClass>com.xtool.manager.MainDemo</mainClass>
                    <finalName>XTool</finalName>
					 <includes>
                            <include>
                                <groupId>nothing</groupId>
                                <artifactId>nothing</artifactId>
                            </include>
                     </includes>
                </configuration>
                <executions>
                    <execution>
                        <goals>
                            <goal>repackage</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>

说明：

mainClass 标签里是你的项目的启动类的包路径,如果你的项目没有有启动类也不需要通过 java -jar 运行的话可以删除 mainClass
finalName 标签里的就是打出来的 jar 名，我这里是 XTool ，最终生成的就是 XTool.jar 。若不使用 finalName 指定，则打包生成的 jar 包名默认使用 pom.xml 文件里 artifactId 标签和 version 标签里的值作为 jar 的名。
如果你希望最终生成的 jar 包不包含第三方依赖那直接用上面的插件配置即可。如果希望最终生成的 jar 包里包含第三方依赖那就删除 includes 标签及其里面的内容

3.在 idea 右边侧边栏的 Maven 选项卡里点击 Lifecyle 下的 package 就可以开始打包了

最终生成的 jar 包就在 target 目录下

如果使用这种打包方式问题任然存在，可以尝试使用 idea 来打包，可参考我另一篇文章：idea 项目代码打包为jar包

总结

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

Java设计模式之责任链模式的概念、实现以及netty中的责任链模式
这篇文章主要给大家介绍了关于设计模式之责任链模式的概念、实现以及netty中的责任链模式的相关资料，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2020-12-12
通过实例解析JMM和Volatile底层原理
这篇文章主要介绍了通过实例解析JMM和Volatile底层原理,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-01-01
springboot项目打docker镜像实例(入门级)
最近做个项目,我们想把自己的程序打包成镜像,并运行在docker容器中,本文主要介绍了springboot项目打docker镜像实例,具有一定的参考价值,感兴趣的可以了解一下
2024-06-06
idea compile项目正常启动项目的时候build失败报“找不到符号”等问题及解决方案
这篇文章主要介绍了idea compile项目正常，启动项目的时候build失败，报“找不到符号”等问题,这种问题属于lombok编译失败导致，可能原因是依赖jar包没有更新到最新版本，需要的朋友可以参考下
2023-10-10
Java 中Object的wait() notify() notifyAll()方法使用
这篇文章主要介绍了Java 中Object的wait() notify() notifyAll()方法使用的相关资料,需要的朋友可以参考下
2017-05-05
SpringBoot异步导出文件的实现步骤
本文主要介绍了SpringBoot异步导出文件的实现步骤,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
2025-09-09
Java中编译期异常和运行期异常的区别解析
Java中的异常分为运行期异常（RuntimeException）和编译期异常（CheckedException）,前者不强制处理,后者必须显式处理,本文介绍Java中编译期异常和运行期异常的区别,感兴趣的朋友一起看看吧
2025-02-02
教你用JAVA写文本编辑器(二)
之前介绍了JAVA写文本编辑器的基本思路,下面这篇文章就来给大家介绍了关于用JAVA写文本编辑器的相关资料,文中通过实例代码介绍的非常详细,需要的朋友可以参考下
2021-11-11
Java 集合去重的三种方法
本主要介绍了Java 集合去重的三种方法,包含HashSet,Stream API和手动遍历并使用Map三种,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
2024-07-07
Java数组判断是否越界的示例代码
在Java编程中,避免数组越界是十分重要的,本文介绍了两种常见的判断数组是否越界的方法：一是通过数组的length属性来判断索引是否合法；二是通过捕获ArrayIndexOutOfBoundsException异常来处理越界问题,感兴趣的朋友跟随小编一起看看吧
2024-09-09