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

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解压，看看里面究竟少了什么。

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

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

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

解决

既然找到了病根，接下来就是对症下药。对于使用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运行的独立包，那就需要删除整个...标签及其内容。

第三步，执行打包。配置好后，在IntelliJ IDEA右侧的Ma ven工具窗口中，找到Lifecycle下的package，点击它，静静等待打包完成。

打包成功的jar包，会乖乖地躺在项目的target目录下。

如果按照以上步骤操作后问题依旧，不妨换个思路，尝试直接用IDEA内置的功能来打包。具体方法可以参考另一篇详细的指南：idea 项目代码打包为jar包。

总结

总的来说，“no main manifest attribute”这个错误就像一个守门员，它提醒我们打包时别忘了指定程序的起点。通过正确配置Ma ven插件，明确主类路径，就能轻松跨过这道坎。希望以上的分析和步骤能为大家提供一个清晰的解决思路。

您可能感兴趣的文章:

• 项目打包成jar后包无法读取src/main/resources下文件的解决
• IDEA打包jar-解决找不到或无法加载主类 main的问题
• ja va打包成jar并执行jar包中指定的main方法