Maven私服上傳WAR包報400錯誤？核心原因與解決之道

問題現場

新手在MyEclipse執行clean install deploy，WAR包錯誤上傳到Releases庫並報400 Bad Request。

核心誤區：Maven倉庫的約定俗成

Maven標準生命週期設計為構建JAR包，WAR屬於Web應用部署制品，不屬於Maven依賴管理體系核心範疇。

為什麼會報400？

1. 倉庫策略不匹配： 私服（如Nexus）Releases庫通常禁止覆蓋部署，SNAPSHOT版本才允許重複部署
2. POM打包類型錯誤： <packaging>war</packaging> 導致Maven嘗試按庫規則部署
3. 缺少WAR部署插件配置： 需配置wagon或maven-deploy-plugin支援Web容器部署

正確的Web項目部署路徑

方案一：Maven構建 + 獨立部署（推薦）

<build>
  <plugins>
    <!-- 僅構建WAR，不部署到Maven倉庫 -->
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-war-plugin</artifactId>
      <configuration>
        <attachClasses>true</attachClasses> <!-- 同時輸出classes jar -->
      </configuration>
    </plugin>
  </plugins>
</build>

構建產出target/*.war，再通過Jenkins/Ansible/Docker部署到Tomcat/K8s。

方案二：確需上傳私服（如多模組共享）

<distributionManagement>
  <snapshotRepository>
    <id>nexus-snapshots</id>
    <url>https://nexus/content/repositories/snapshots/</url>
  </snapshotRepository>
  <repository>
    <id>nexus-releases</id>
    <url>https://nexus/content/repositories/releases/</url>
  </repository>
</distributionManagement>

-- 版本號必須帶-SNAPSHOT後綴
mvn clean deploy -DskipTests

最佳實踐總結

• Maven倉庫管理依賴制品，不管理部署制品
• WAR/JAR/EAR區分：構建階段產出，部署階段消費
• 私服權限：Releases唯讀，Snapshots可覆蓋