SpringBoot项目 Java -jar XXX.jar 没有主清单属性解决方法

SpringBoot项目 Java -jar XXX.jar 没有主清单属性的解决方案

什么是主清单属性？

主清单属性是Java存档（JAR）文件中的一个特殊属性，它指定程序的主类。当使用 java -jar 命令运行 JAR 文件时，Java 虚拟机 (JVM) 会查找主清单属性并加载指定的主类。如果没有主清单属性，JVM 将无法确定程序的入口点并抛出 "没有主清单属性" 错误。

原因和解决方案

"没有主清单属性" 错误通常由以下原因引起：

• 依赖冲突： JAR 文件中不同依赖项之间的版本不兼容。
• 版本不匹配： JAR 文件中的依赖项版本与项目实际使用的版本不匹配。
• Maven 配置错误： Maven 打包时参数设置不当，导致 JAR 文件中不包含主清单属性。
• Java 编译器参数错误： Java 编译器在编译源代码时参数设置不当，导致生成的 JAR 文件中不包含主清单属性。

要解决此错误，您可以尝试以下解决方案：

检查依赖关系

确保 JAR 文件中的所有依赖项版本兼容，并且使用相同的版本。

更新依赖项版本

将 JAR 文件中的依赖项版本更新到与项目实际使用的版本一致。

配置 Maven 参数

在 POM 文件中添加以下配置：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-jar-plugin</artifactId>
    <configuration>
        <archive>
            <manifest>
                <mainClass>com.example.Main</mainClass>
            </manifest>
        </archive>
    </configuration>
</plugin>

修改 Java 编译器参数

在 Java 编译器命令中添加 -main-class 参数，指定主类：

javac -cp ... -main-class com.example.Main Main.java

其他提示

• 确保 JAR 文件的名称与 mainClass 指定的主类的名称匹配。
• 如果您仍然遇到问题，请尝试使用 Maven Shade 插件合并依赖项并生成一个新的 JAR 文件。
• 在极少数情况下，您可能需要手动编辑 JAR 文件的清单属性。可以使用 jar xf 和 jar uf 命令分别提取和更新清单属性。

常见问题解答

问：为什么我需要指定主清单属性？

答：JVM 需要知道程序的入口点才能加载和运行它。主清单属性指定了此入口点。

问：如何查看 JAR 文件的主清单属性？

答：使用 jar tf 命令，后跟 JAR 文件的名称，例如：

jar tf myapp.jar

问：为什么在 Maven 项目中使用 spring-boot-maven-plugin 会导致此错误？

答：spring-boot-maven-plugin 默认情况下会将 Spring Boot 的 SpringBootApplication 类作为主类。如果您在项目中指定了自己的主类，则需要在插件配置中覆盖默认值。

问：如何手动编辑 JAR 文件的清单属性？

答：使用以下命令：

• 提取清单属性：jar xf myapp.jar
• 修改清单属性：echo Main-Class: com.example.Main > manifest.mf
• 更新清单属性：jar uf myapp.jar manifest.mf

问：我尝试了所有这些解决方案，但仍然出现错误。该怎么办？

答：如果您仍然遇到问题，请联系技术社区或 Spring Boot 支持团队寻求进一步的帮助。