Java 項目打包部署完全指南：從 JAR 到 EXE、Maven 多模塊構建一網打盡

關鍵點：Main-Class 指定入口類全限定名；Class-Path 列出依賴 JAR 相對路徑（需與 app.jar 同級目錄）。

方案二：打包為 EXE（無需用戶安裝 JDK）

• Launch4j：開源免費，將 JAR 包裝為 Windows EXE，可捆綁 JRE、配置圖標、JVM 參數、單實例運行。官網下載
• jpackage (JDK 14+)：原生工具，生成平台原生安裝包（Windows MSI/EXE、macOS DMG/PKG、Linux DEB/RPM）。
  jpackage --input libs --main-jar app.jar --name MyApp --type exe
• GraalVM Native Image：提前編譯為原生機器碼，啟動極快、內存極低，但需處理反射/動態代理配置。

方案三：Maven 多模塊項目構建

<project>
  <packaging>pom</packaging>
  <modules>
    <module>common</module>
    <module>service</module>
    <module>web</module>
  </modules>
  
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-shade-plugin</artifactId>
        <version>3.4.1</version>
        <configuration>
          <transformers>
            <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
              <mainClass>com.example.Application</mainClass>
            </transformer>
          </transformers>
        </configuration>
        <executions>
          <execution>
            <phase>package</phase>
            <goals><goal>shade</goal></goals>
          </execution>
        </executions>
      </plugin>
    </plugins>
  </build>
</project>

執行 mvn clean package，在各模塊 target/ 生成可執行 Fat JAR（含所有依賴）。

IDE 一鍵打包（輔助）

• IntelliJ IDEA：File → Project Structure → Artifacts → + → JAR → From modules with dependencies，指定 Main Class，Build → Build Artifacts。
• Eclipse：右鍵項目 → Export → Java → Runnable JAR file，選擇 Package required libraries into generated JAR。

避坑清單

1. 資源文件（配置、模板）需放在 src/main/resources，打包後通過 ClassLoader.getResourceAsStream() 讀取。
2. 第三方庫若包含 META-INF/services/（SPI 機制），需用 maven-shade-plugin 的 ServicesResourceTransformer 合併。
3. 日誌框架配置文件 (logback.xml, log4j2.xml) 必須在 classpath 根目錄。