## 問題復現
在使用 `java -jar xxx.jar` 命令運行 Java 應用程序時,遇到了以下錯誤:
```
xxx.jar 中沒有主清單屬性
```

這個錯誤表示 JAR 文件缺少必要的啟動信息,Java 虛擬機無法找到應用程序的入口點。本文將介紹該錯誤的原因以及如何通過修改 `pom.xml` 文件來解決。
---
## 錯誤原因
當你使用 `java -jar` 命令運行一個 JAR 文件時,Java 虛擬機會在該 JAR 的 `META-INF/MANIFEST.MF` 文件中查找 `Main-Class` 屬性,以確定應用程序的入口點。如果該屬性缺失,或者指定的主類不存在,就會導致上述錯誤。
---
## 解決方法
要解決這個問題,需要在項目的 `pom.xml` 文件中配置 Maven 插件,以正確生成包含 `Main-Class` 屬性的可執行 JAR 文件。
### 步驟一:在 `pom.xml` 中添加或修改 `<build>` 配置
在你的 `pom.xml` 文件中,找到或添加 `<build>` 部分。

然后修補上以下內容:
```xml
<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 源代碼和目標版本,以及編碼格式。
- **Spring Boot Maven Plugin**:
- `<mainClass>`:指定應用程序的主類,必須包含 `main` 方法。請將 `xxx.xxx.rxxxdc.xxxApplication` 替換為你實際的主類路徑。
- `<skip>false</skip>`:確保插件不會被跳過,默認情況下可以省略該配置。
- `<executions>`:指定在構建過程中執行 `repackage` 目標,重新打包 JAR 文件。
---
### 步驟二:重新構建項目
在項目根目錄下,運行以下命令:
```bash
mvn clean package
```
這將清理項目并重新打包,生成的 JAR 文件通常位于 `target` 目錄下,名稱類似于 `xxx.jar`。
也可以在 `IDEA` 的 `Maven` 菜單里右鍵操作。
先運行 `clean`。

再運行 `package`。

---
### 步驟三:運行生成的 JAR 文件
使用以下命令運行應用程序:
```bash
java -jar target/xxx.jar
```
如果配置正確,應用程序應該能夠正常啟動,不再出現 “沒有主清單屬性” 的錯誤。

---
## 注意事項
- **確認主類存在且路徑正確**:確保你的主類(例如 `xxxApplication`)存在,并且位于指定的包路徑下(例如 `xxx.xxx.xxx`)。
- **版本一致性**:`spring-boot-maven-plugin` 的版本應與 Spring Boot 的版本一致,通常使用 `${spring-boot.version}` 引用。
- **避免插件被跳過**:確保 `<skip>false</skip>`,避免插件被跳過。
- **重新打包**:確保 `<executions></executions>`標簽及內部的`repackage`屬性存在。
---
## 結論
通過在 `pom.xml` 文件中正確配置 Maven 插件,可以解決 `java -jar` 命令運行時出現的 “沒有主清單屬性” 的錯誤。關鍵是確保生成的 JAR 文件包含正確的 `Main-Class` 屬性,以及所有必要的依賴項。
希望本篇文章能夠幫助你解決問題,順利運行你的 Java 應用程序。