Maven 專案快速執行 Java Main 類的三種姿勢

告別 IDE 依賴：命令列一鍵啟動 Main 方法

在 CI/CD、伺服器部署或無形介面環境中，透過 Maven 直接啟動含 main 方法的類別是必備技能。本文整理三種常用指令，涵蓋編譯、無參執行、帶參數執行。

前置條件

• 專案為標準 Maven 結構（src/main/java）
• 目標類別包含 public static void main(String[] args)
• 已安裝 Maven 並配置環境變數

指令速查表

插件配置（可選優化）

在 pom.xml 中顯式宣告插件版本，避免版本衝突：

<plugin>
  <groupId>org.codehaus.mojo</groupId>
  <artifactId>exec-maven-plugin</artifactId>
  <version>3.1.0</version>
  <configuration>
    <mainClass>com.example.Main</mainClass> <!-- 預設主類，命令列可覆蓋 -->
  </configuration>
</plugin>

配置後可簡化為 mvn exec:java 直接跑預設主類。

常見坑點與解法

• ClassNotFound：確認已執行 mvn compile 或 mvn package，類別檔案存在。
• 依賴缺失：執行階段需完整 classpath，exec:java 會自動載入 compile 作用域依賴；若用 java -cp 需手動拼接所有 jar。
• 模組化專案：多模組時需在對應模組目錄下執行，或指定 -pl module-name。

替代方案

若需產出可獨立部署的 Fat JAR，建議使用 maven-shade-plugin 或 spring-boot-maven-plugin 打包後以 java -jar 執行，效能與攜帶性更佳。