Spring Maven项目pom.xml报错：webappstructureserializer类初始化失败

问题详情 #

开发Spring Maven项目时，执行构建命令遇到报错：

could not initialize class org.apache.maven.plugin.war.util.webappstructureserializer

项目pom.xml核心配置片段：

<project xmlns="http://maven.apache.org/POM/4.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>ibank</groupId>
    <artifactId>ibank</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>war</packaging>
    <name>ibank</name>
    <description>With REST</description>

    <build>
        <finalName>ibank</finalName>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.5.1</version>
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                </configuration>
            </plugin>
        <!-- 缺少显式的maven-war-plugin配置 -->
        </plugins>
    </build>
</project>

已尝试修改插件版本，问题仍存在。

可行解决方案 #

• 显式指定兼容的maven-war-plugin版本
  默认依赖的war插件可能与当前Maven版本不匹配，在pom.xml的build/plugins节点下添加war插件配置：

  <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-war-plugin</artifactId>
      <!-- 3.3.2为适配Maven 3.6+的稳定版，可根据你的Maven版本调整 -->
      <version>3.3.2</version>
  </plugin>
  

  执行命令强制更新依赖并构建：

  mvn clean install -U
  

• 修复本地Maven仓库损坏的依赖
  本地仓库中war插件的jar包可能损坏，删除以下路径的文件：

  ~/.m2/repository/org/apache/maven/plugins/maven-war-plugin
  

  删除后重新执行构建命令，Maven会自动重新下载完整的依赖文件。

• 对齐JDK版本
  项目指定了JDK 1.8编译，需确保Maven运行时使用的JDK也是1.8。执行mvn -v查看Maven关联的JDK版本，若不一致，修改环境变量MAVEN_JAVA_HOME指向JDK 1.8目录。

• 清理项目缓存
  删除项目根目录下的target文件夹，执行mvn clean清理编译残留，再重新执行mvn install构建项目。

内容的提问来源于stack exchange，提问作者YRR