Springboot jar主清单属性丢失解决方案

Spring Boot应用程序通常被打包为可执行的JAR包。这些JAR包包含了应用程序的全部依赖项以及主清单文件。然而，有时候在构建JAR包时会遇到主清单属性丢失的问题。本文将提供多个解决方案，帮助你解决这些问题。

问题原因分析

当你使用Maven或Gradle构建Spring Boot应用程序时，可以在构建脚本中指定应用程序的主类和其他的主清单属性，例如应用程序的名称、版本和描述等信息。

如果构建脚本中没有正确配置这些属性，或者某些属性值为空，构建出的JAR包就会缺少主清单属性。这时，使用java -jar命令启动应用程序可能会收到错误信息：

no main manifest attribute, in spring-boot-app.jar

这是因为Java虚拟机需要从JAR文件中的主清单文件中获取该应用程序的主类信息，以便启动应用程序。如果主清单文件中未指定该属性，则会出现上述错误。

解决方案

在下面，提供两种解决方案，帮助你解决可能出现的主清单属性丢失问题。

Maven插件解决方案

Maven提供了maven-jar-plugin插件用于构建JAR包，并且提供了一个选项来设置JAR文件的主清单属性。在maven-jar-plugin中配置MANIFEST.MF属性可以将应用程序的主类和其他属性信息指定为JAR文件的主清单属性。下面是maven-jar-plugin的示例配置：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-jar-plugin</artifactId>
    <version>${maven-jar-plugin.version}</version>
    <configuration>
        <archive>
            <manifest>
                <mainClass>com.example.Application</mainClass>
                <packageName>com.example</packageName>
                <description>示例Spring Boot应用程序</description>
                <version>1.0.0</version>
            </manifest>
        </archive>
    </configuration>
</plugin>

在上面的配置中，mainClass属性指定了Spring Boot应用程序的主类，${packageName}，${description}和${version}属性用于指定应用程序的其他属性信息。配置完成后，执行mvn clean package命令重新构建应用程序，就会生成包含正确主清单属性的JAR文件。

Spring Boot Gradle解决方案

如果你使用Gradle构建Spring Boot应用程序，可以使用Gradle的org.springframework.boot插件来构建JAR文件。该插件会将应用程序的主类自动填充到JAR文件的主清单属性中，无需任何额外配置。下面是Spring Boot Gradle插件的示例配置：

plugins {
    id 'org.springframework.boot' version '2.4.3'
}

在上面的配置中，只需使用Spring Boot Gradle插件即可自动填充JAR文件的主清单属性值，无需任何其他配置。

总结

在使用Spring Boot构建可执行的JAR包时，遇到主清单属性丢失的问题时应该首先检查构建脚本中是否正确配置了mainClass属性。如果使用Maven构建应用程序，则可以通过配置maven-jar-plugin插件来指定主清单属性。如果使用Gradle构建，则可以使用Spring Boot Gradle插件，无需任何额外的配置。