SpringBoot程序打包失败（.jar中没有主清单属性）处理

墨蓝 2023-10-12 22:56 41阅读 0赞

最近在学习SpringBoot，打包SpringBoot程序后，在cmd运行出现了 某某某.jar中没有注清单属性 。

![format_png][]

我当时也是很懵逼，就去万能的互联网寻求帮助，累计找了大概十几篇文章吧，最后总算是在一个网友的评论中得到了答案，在此先感谢那位留下评论的热心网友。

# 我的错误 #

说明一下，我的SpringBoot模板是基于aliyun镜像创建的。

在默认给出的配置的环境下，pom.xml中是有`spring-boot-maven-plugin`这个依赖的，所以可以先排除没有这个依赖的说法。

我用maven打包后，只给出了一个内存较小的jar文件，运行这个文件，就会出现上述没有主属性清单的错误，至于这个jar文件为何会出现这个错误，我会在文章的下面讲。

在看到这位热心网友的评论时，我也不明白是因为什么，根据TA的说法，我更改的默认的配置，唉，成了，在打包后出现了两个jar。

![format_png 1][]

运行那个内存占用较大的jar，运行成功（喜）。而为什么要运行占用内存较大的呢，也在后文做解释。

# 解决方法 #

我的解决方案：

对pom.xml文件做如下修改

xml复制代码<build>
    	<plugins>
    		<plugin>
    			<groupId>org.apache.maven.plugins</groupId>
                       <artifactId>maven-compiler-plugin</artifactId>
                       <version>3.8.1</version>
                       <configuration>
                           <source>1.8</source>
                           <target>1.8</target>
                           <encoding>UTF-8</encoding>
                       </configuration>
    		</plugin>
    		<plugin>
    			<groupId>org.springframework.boot</groupId>
                       <artifactId>spring-boot-maven-plugin</artifactId>
                       <version>${spring-boot.version}</version>
                       
                       
                       <executions>
                           <execution>
                               <id>repackage</id>
                               <goals>
                                   <goal>repackage</goal>
                               </goals>
                           </execution>
                       </executions>
             </plugin>
    	</plugins>
    </build>

# 错误分析 #

要想搞清楚这个问题就要说说.jar文件的工作机制了，知道了这个东西就知道如何避免此类问题的发生了。

搞java开发平时会接触很多jar包，比如mysql的驱动jar包，而上面我们打包程序后得到的也是一个jar文件。这个时候如果你使用上面的java -jar指令去执行mysql的驱动jar包就会出现上述不可执行的现象。

而SpringBoot项目为什么能执行呢？其实是因为打包方式不一样。

xml复制代码<plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
    </plugin>

我们分别开启这段配置和注释掉这段配置分别执行两次打包，然后观察两次打包后的程序包的差别，共有3处比较明显的特征：

1、打包后文件的大小不同  
2、打包后所包含的内容不同  
3、打包程序中个别文件内容不同

## 大小不同 ##

先看第一个现象，文件大小不同。带有配置时打包生成的程序包大小如下：

![format_png 1][]

## 包含内容不同 ##

不难看出，带有配置的程序包体积比不带配置的大了30倍，看看里面的内容有什么区别。

![format_png 2][]

![format_png 3][]

发现内容也完全不一样，仅有一个目录是一样的，叫做META-INF。打开容量大的程序包中的BOOT-INF目录下的classes目录，发现其中的内容居然和容量小的程序包中的内容完全一样。

![format_png 4][]

![format_png 5][]

原来大的程序包中除了包含小的程序包中的内容，还有别的东西。回到BOOT-INF目录下，打开lib目录，里面显示了很多个jar文件。

![format_png 6][]

这些jar文件都是我们制作这个工程时导入的坐标对应的文件。SpringBoot程序为了让自己打包生成的程序可以独立运行，不仅将项目中自己开发的内容进行了打包，还把当前工程运行需要使用的jar包全部打包进来了。  
这样做就是为了可以独立运行。不依赖程序包外部的任何资源可以独立运行当前程序。这也是为什么大的程序包容量是小的程序包容量的30倍的主要原因。

再看看大程序包还有什么不同之处，在最外层目录包含一个org目录，进入此目录，目录名是org\\springframework\\boot\\loader，在里面可以找到一个**JarLauncher.class**的文件。再看这套目录名，明显是一个Spring的目录名。

## 个别文件内容不同 ##

回到两个程序包的最外层目录，查看名称相同的文件夹META-INF下都有一个叫做MANIFEST.MF的文件，但是大小不同，打开文件，比较内容区别

小容量文件的MANIFEST.MF

makefile复制代码Manifest-Version: 1.0
    Archiver-Version: Plexus Archiver
    Built-By: 名字
    Created-By: Apache Maven 3.8.1
    Build-Jdk: 1.8.0_201

大容量文件的MANIFEST.MF

makefile复制代码Manifest-Version: 1.0
    Spring-Boot-Classpath-Index: BOOT-INF/classpath.idx
    Archiver-Version: Plexus Archiver
    Built-By: 名字
    Spring-Boot-Layers-Index: BOOT-INF/layers.idx
    Start-Class: com.sun.SSMPApplication
    Spring-Boot-Classes: BOOT-INF/classes/
    Spring-Boot-Lib: BOOT-INF/lib/
    Spring-Boot-Version: 2.6.13
    Created-By: Apache Maven 3.8.1
    Build-Jdk: 1.8.0_201
    Main-Class: org.springframework.boot.loader.JarLauncher

大文件中明显比小文件中多了几行信息，其中最后一行信息是Main-Class:

org.springframework.boot.loader.**JarLauncher**。即如果使用java -jar执行此程序包，将执行Main-Class属性配置的类，这个类恰巧就是前面看到的那个文件。原来SpringBoot打包程序中出现Spring框架的东西是为这里服务的。而这个org.springframework.boot.loader.**JarLauncher**类内部要查找Start-Class属性中配置的类，并执行对应的类。这个属性在当前配置中也存在，对应的就是我们的引导类类名。

1.  SpringBoot程序添加配置后会打出一个特殊的包，包含Spring框架部分功能，原始工程内容，原始工程依赖的jar包
2.  首先读取MANIFEST.MF文件中的Main-Class属性，用来标记执行java -jar命令后运行的类
3.  JarLauncher类执行时会找到Start-Class属性，也就是启动类类名
4.  运行启动类时会运行当前工程的内容
5.  运行当前工程时会使用依赖的jar包，从lib目录中查找

SpringBoot打出来了包为了能够独立运行，将所有需要使用的资源全部都添加到了这个包里。这就是为什么这个jar包能独立运行的原因。

## 总结 ##

再来看之前的报错信息：

![format_png][]

由于打包时没有使用那段配置，结果打包后形成了一个普通的jar包，在MANIFEST.MF文件中也就没有了Main-Class对应的属性了，所以运行时提示找不到主清单属性，这就是报错的原因。

[format_png]: https://img-blog.csdnimg.cn/img_convert/cbaff43f206649e175af4ae1ae076cf1.webp?x-oss-process=image/format,png
[format_png 1]: https://img-blog.csdnimg.cn/img_convert/f07fc84b69f3fd2b1560207c8b5e5f1d.webp?x-oss-process=image/format,png
[format_png 2]: https://img-blog.csdnimg.cn/img_convert/58847370cfa25e942d10606943ca1a57.webp?x-oss-process=image/format,png
[format_png 3]: https://img-blog.csdnimg.cn/img_convert/1bcf909070da02591e7a1ebaabfa4775.webp?x-oss-process=image/format,png
[format_png 4]: https://img-blog.csdnimg.cn/img_convert/7473c062ecbe7baaeccad97387119180.webp?x-oss-process=image/format,png
[format_png 5]: https://img-blog.csdnimg.cn/img_convert/1ef32983c988b3c90f39192cc6f86996.webp?x-oss-process=image/format,png
[format_png 6]: https://img-blog.csdnimg.cn/img_convert/d60f01c38277b56398e22cde673d5c64.webp?x-oss-process=image/format,png