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

maven 打包 spring boot 没有主程序清单 maven打包没有主清单属性_jar

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

我的错误

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

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

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

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

maven 打包 spring boot 没有主程序清单 maven打包没有主清单属性_jar_02

运行那个内存占用较大的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>
                   <!-- 把这里给删除就可以打包成功 -->
                   <!--<configuration>
                       <mainClass>com.sun.SSMPApplication</mainClass>
                       <skip>true</skip>
                   </configuration>-->
                   <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、打包程序中个别文件内容不同

大小不同

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

maven 打包 spring boot 没有主程序清单 maven打包没有主清单属性_jar_02

包含内容不同

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

maven 打包 spring boot 没有主程序清单 maven打包没有主清单属性_jar_04

maven 打包 spring boot 没有主程序清单 maven打包没有主清单属性_jar包_05

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

maven 打包 spring boot 没有主程序清单 maven打包没有主清单属性_spring boot_06

maven 打包 spring boot 没有主程序清单 maven打包没有主清单属性_jar包_07

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

maven 打包 spring boot 没有主程序清单 maven打包没有主清单属性_后端_08

这些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包能独立运行的原因。

总结

再来看之前的报错信息:

maven 打包 spring boot 没有主程序清单 maven打包没有主清单属性_jar

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