jar运行报错nomainmanifestattribute原因分析及解决

首页

编程语言

热心网友

转载

2026-05-05

jar运行报错no main manifest attribute

部署到服务器，满怀期待地执行那条经典命令：

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

ja va -jar test-0.0.1-SNAPSHOT.jar

结果迎面而来的却是一盆冷水：

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

别慌，这个问题在Ja va开发中相当常见，本质上就是系统在跟你“要人”——它不知道应该从哪个“入口”开始执行你的程序。

原因

问题的核心直截了当：找不到主类。

Ja va程序打包成可执行的jar包，有一个关键约定：必须在MANIFEST.MF文件中明确指定Main-Class项。这就像是给jar包一张“说明书”，告诉ja va -jar命令：“嘿，请从我这个类开始运行。”

我们来做个现场勘查。把报错的test-0.0.1-SNAPSHOT.jar解压，看看里面究竟少了什么。

jar运行报错nomainmanifestattribute原因分析及解决

找到META-INF目录下的MANIFEST.MF文件，打开一看，真相大白。

jar运行报错nomainmanifestattribute原因分析及解决

看到了吗？文件里空空如也，或者缺少了关键的Main-Class行。而一个正常的、能直接运行的jar包，它的清单文件应该是这样的：

jar运行报错nomainmanifestattribute原因分析及解决

对比之下，问题一目了然。

解决

既然找到了病根，接下来就是对症下药。对于使用Ma ven管理的Spring Boot项目，修复起来其实很有章法。

第一步，检查基础配置。先确认你的pom.xml里是否已经声明了打包方式为jar。如果缺少，赶紧加上：

jar

第二步，也是关键一步，配置打包插件。在pom.xml的 -> 部分，加入Spring Boot Ma ven插件，并指定好主类：

            
                org.springframework.boot
                spring-boot-ma ven-plugin
                2.6.0
                
                    com.xtool.manager.MainDemo
                    XTool
					 
                            
                                nothing
                                nothing
                            
                     
                
                
                    
                        
                            repackage

这里有几个配置点需要划下重点：

mainClass：这里必须填写你项目启动类的完整包路径。如果你的项目不是可执行应用，自然不需要配置这一项。
finalName：这决定了最终生成的jar包名字。比如这里配置XToolXTool.jar。如果不指定，Ma ven会默认使用artifactId和version来拼接文件名。
includes 标签：这个配置有点意思。如果你希望生成的“胖jar包”不包含任何第三方依赖，保留这个配置即可。反之，如果你想打一个包含所有依赖的、可以直接用ja va -jar运行的独立包，那就需要删除整个...标签及其内容。