快捷導(dǎo)航

解決java-jar報錯：xxx.jar 中沒有主清單屬性的方法

更新時間：2024年11月27日 08:53:58 作者：Damon小智

在使用 java -jar xxx.jar 命令運行 Java 應(yīng)用程序時,遇到了以下錯誤：xxx.jar 中沒有主清單屬性,這個錯誤表示 JAR 文件缺少必要的啟動信息,本文將介紹該錯誤的原因以及如何通過修改 pom.xml 文件來解決,需要的朋友可以參考下

問題復(fù)現(xiàn)

在使用 java -jar xxx.jar 命令運行 Java 應(yīng)用程序時，遇到了以下錯誤：

xxx.jar 中沒有主清單屬性

在這里插入圖片描述

這個錯誤表示 JAR 文件缺少必要的啟動信息，Java 虛擬機無法找到應(yīng)用程序的入口點。本文將介紹該錯誤的原因以及如何通過修改 pom.xml 文件來解決。

錯誤原因

當(dāng)你使用 java -jar 命令運行一個 JAR 文件時，Java 虛擬機會在該 JAR 的 META-INF/MANIFEST.MF 文件中查找 Main-Class 屬性，以確定應(yīng)用程序的入口點。如果該屬性缺失，或者指定的主類不存在，就會導(dǎo)致上述錯誤。

解決方法

要解決這個問題，需要在項目的 pom.xml 文件中配置 Maven 插件，以正確生成包含 Main-Class 屬性的可執(zhí)行 JAR 文件。

步驟一：在 pom.xml 中添加或修改 <build> 配置

在你的 pom.xml 文件中，找到或添加 <build> 部分。

然后修補上以下內(nèi)容：

<build>
    <plugins>
        <!-- Maven Compiler Plugin -->
        <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>

        <!-- Spring Boot Maven Plugin -->
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <version>${spring-boot.version}</version>
            <configuration>
                <mainClass>xxx.xxx.xxx.xxxApplication</mainClass>
                <skip>false</skip>
            </configuration>
            <executions>
                <execution>
                    <id>repackage</id>
                    <goals>
                        <goal>repackage</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

配置說明：

Maven Compiler Plugin：指定了 Java 源代碼和目標(biāo)版本，以及編碼格式。
Spring Boot Maven Plugin：
- <mainClass>：指定應(yīng)用程序的主類，必須包含 main 方法。請將 xxx.xxx.rxxxdc.xxxApplication 替換為你實際的主類路徑。
- <skip>false</skip>：確保插件不會被跳過，默認(rèn)情況下可以省略該配置。
- <executions>：指定在構(gòu)建過程中執(zhí)行 repackage 目標(biāo)，重新打包 JAR 文件

步驟二：重新構(gòu)建項目

在項目根目錄下，運行以下命令：

mvn clean package

這將清理項目并重新打包，生成的 JAR 文件通常位于 target 目錄下，名稱類似于 xxx.jar。

也可以在 IDEA 的 Maven 菜單里右鍵操作。

先運行 clean。

在這里插入圖片描述

再運行 package。

在這里插入圖片描述

步驟三：運行生成的 JAR 文件

使用以下命令運行應(yīng)用程序：

java -jar target/xxx.jar

如果配置正確，應(yīng)用程序應(yīng)該能夠正常啟動，不再出現(xiàn) “沒有主清單屬性” 的錯誤。

在這里插入圖片描述

注意事項

確認(rèn)主類存在且路徑正確：確保你的主類（例如 xxxApplication）存在，并且位于指定的包路徑下（例如 xxx.xxx.xxx）。
版本一致性：spring-boot-maven-plugin 的版本應(yīng)與 Spring Boot 的版本一致，通常使用 ${spring-boot.version} 引用。
避免插件被跳過：確保 <skip>false</skip>，避免插件被跳過。
重新打包：確保 <executions></executions>標(biāo)簽及內(nèi)部的repackage屬性存在。