最近在学习SpringBoot,打包SpringBoot程序后,在cmd运行出现了 某某某.jar中没有注清单属性 。
我当时也是很懵逼,就去万能的互联网寻求帮助,累计找了大概十几篇文章吧,最后总算是在一个网友的评论中得到了答案,在此先感谢那位留下评论的热心网友。
我的错误
说明一下,我的SpringBoot模板是基于aliyun镜像创建的。
在默认给出的配置的环境下,pom.xml中是有spring-boot-maven-plugin
这个依赖的,所以可以先排除没有这个依赖的说法。
我用maven打包后,只给出了一个内存较小的jar文件,运行这个文件,就会出现上述没有主属性清单的错误,至于这个jar文件为何会出现这个错误,我会在文章的下面讲。
在看到这位热心网友的评论时,我也不明白是因为什么,根据TA的说法,我更改的默认的配置,唉,成了,在打包后出现了两个jar。
运行那个内存占用较大的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、打包程序中个别文件内容不同
大小不同
先看第一个现象,文件大小不同。带有配置时打包生成的程序包大小如下:
包含内容不同
不难看出,带有配置的程序包体积比不带配置的大了30倍,看看里面的内容有什么区别。
发现内容也完全不一样,仅有一个目录是一样的,叫做META-INF。打开容量大的程序包中的BOOT-INF目录下的classes目录,发现其中的内容居然和容量小的程序包中的内容完全一样。
原来大的程序包中除了包含小的程序包中的内容,还有别的东西。回到BOOT-INF目录下,打开lib目录,里面显示了很多个jar文件。
这些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属性中配置的类,并执行对应的类。这个属性在当前配置中也存在,对应的就是我们的引导类类名。
- SpringBoot程序添加配置后会打出一个特殊的包,包含Spring框架部分功能,原始工程内容,原始工程依赖的jar包
- 首先读取MANIFEST.MF文件中的Main-Class属性,用来标记执行java -jar命令后运行的类
- JarLauncher类执行时会找到Start-Class属性,也就是启动类类名
- 运行启动类时会运行当前工程的内容
- 运行当前工程时会使用依赖的jar包,从lib目录中查找
SpringBoot打出来了包为了能够独立运行,将所有需要使用的资源全部都添加到了这个包里。这就是为什么这个jar包能独立运行的原因。
总结
再来看之前的报错信息:
由于打包时没有使用那段配置,结果打包后形成了一个普通的jar包,在MANIFEST.MF文件中也就没有了Main-Class对应的属性了,所以运行时提示找不到主清单属性,这就是报错的原因。