springboot项目打包的可执行jar运行报错问题及解决

更新时间：2026年04月11日 08:43:35 作者：凡人歌者徐

本文介绍了SpringBoot项目打包成可执行jar文件后无法使用java-jar命令启动的问题及解决方法,主要是需要在pom.xml文件中添加spring-boot-maven-plugin插件,以便生成正确的MANIFEST.MF文件

问题展现

现在使用springboot开发spring项目是真的方便快捷，程序开发完成之后，直接打包成一个可执行jar文件，就可以在java环境中运行。

那对于新手小伙伴来说，可能会碰到打包好的可执行jar文件无法通过java -jar命令进行启动，报错提示该可执行jar文件中没有主清单属性，如下所示。

仔细观察该可执行jar文件，发现其只有KB级大小，显然是有问题的。

问题解决

在springboot项目的pom.xml文件中，添加以下节点内容，并重新打包。

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <version>2.2.1.RELEASE</version>
        </plugin>
    </plugins>
</build>

可以看到，加上这段内容之后，重新打包后的jar文件大小就是MB级，再次使用java -jar命令启动也再没有问题。

原理说明

在oracle官网的java文档中有一段话作者进行了部分截取。

The java command starts a Java application. 
If the -jar option is specified, its argument is the name of the JAR file containing class and resource files for the application. 
The startup class must be indicated by the Main-Class manifest header in its source code.

翻译过来就是说，java命令是用来启动一个java应用的，如果java命令后接了-jar选项，那么紧跟的参数就是可执行jar文件的名字，这个可执行jar文件包含了编译好的字节码文件以及资源文件。启动类必须通过源码中的manifest头的Main-Class属性指定。

简单点说，java -jar 命令执行的时候，会去运行可执行jar文件的META-INF/MANIFEST.MF文件中的Main-Class属性指定的类，如果没有找到，就会报没有主清单的错误。

加了spring-boot-maven-plugin插件生成的MANIFEST.MF文件

没加spring-boot-maven-plugin插件生成的MANIFEST.MF文件

总结

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

您可能感兴趣的文章:

Java编程cas操作全面解析
这篇文章通过实例，解析了Java编程中cas操作的概念、原理以及用法，具有一定参考价值，需要的朋友可以了解下。
2017-09-09
java中thread线程start和run的区别
这篇文章主要介绍了java中thread线程start和run的区别,run()是Runnable接口中定义的一个方法，是为了让客户程序员在这个方法里写自己的功能代码的。直接调用和普通的类调用自己的成员方法是没有任何区别的
2014-03-03
Java打印斐波那契前N项的实现示例
这篇文章主要介绍了Java打印斐波那契前N项的实现示例，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2020-02-02
springboot如何获取相对路径文件夹下静态资源的方法
这篇文章主要介绍了springboot如何获取相对路径文件夹下静态资源的方法,小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2019-05-05
Java中SimpleDateFormat日期格式转换详解及代码示例
这篇文章主要介绍了Java中SimpleDateFormat日期格式转换详解及代码示例，具有一定借鉴价值，需要的朋友可以参考下。
2017-12-12
Mybatis拦截器实现自定义需求
本文主要介绍了Mybatis拦截器实现自定义需求，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2023-05-05
maven-maven使用-P参数打包不同环境问题
这篇文章主要介绍了maven-maven使用-P参数打包不同环境问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2023-11-11
Kafka在客户端实现消息的发送与读取
这篇文章主要介绍了Kafka在客户端实现消息的发送与读取,KafkaProducer是用于发送消息的类,ProducerRecord类用于封装Kafka的消息,KafkaProducer的实例化需要指定的参数,Producer的参数定义在 org.apache.kafka.clients.producer.ProducerConfig类中,需要的朋友可以参考下
2023-12-12
如何通过Maven仓库安装Spire系列的Java产品
这篇文章主要介绍了如何通过Maven仓库安装Spire系列的Java产品,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2019-07-07
Java Swing实现画板的简单操作
这篇文章主要介绍了Java Swing实现画板的简单操作，修改颜色，更改图形，清除，任务栏按钮，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2022-06-06