执行mvn install时frontend-maven-plugin重复执行npm run build的原因

核心原因 #

你遇到的npm run build重复执行问题，核心是**maven-surefire-report-plugin的执行触发了Maven增量构建机制，导致前端构建步骤被重复调用**，具体拆解：

1. 执行mvn package时，Maven仅运行到package阶段，前端构建（绑定到prepare-package或package阶段）只会执行一次。
2. 执行mvn install -DskipTests时，Maven会完整运行到install阶段。如果你的pom.xml中把maven-surefire-report-plugin绑定到了package之后的阶段（比如verify或install），该插件执行时可能会修改target目录下的文件（比如生成测试报告到target/site），或者Maven误判该目录状态为“脏”，从而触发之前的prepare-package/package阶段重新执行，导致npm run build再次运行。

另外，也可能是frontend-maven-plugin（1.12.1版本）的旧版本bug，或者你无意中把npm run build目标绑定到了多个生命周期阶段（比如同时绑定prepare-package和install）。

解决步骤 #

• 检查插件绑定阶段：查看pom.xml中maven-surefire-report-plugin的配置，确保它仅绑定到site阶段（默认行为），这样只有执行mvn site时才会生成测试报告，不会干扰install流程。如果不需要测试报告，可直接移除该插件配置。
• 明确前端构建的阶段绑定：为frontend-maven-plugin的npm run build目标明确指定绑定阶段（比如<phase>prepare-package</phase>），同时配置输入输出目录的校验规则，让Maven能准确识别增量构建的条件，避免无意义的重复执行：

  <plugin>
    <groupId>com.github.eirslett</groupId>
    <artifactId>frontend-maven-plugin</artifactId>
    <version>1.12.1</version>
    <executions>
      <execution>
        <id>npm run build</id>
        <phase>prepare-package</phase>
        <goals>
          <goal>npm</goal>
        </goals>
        <configuration>
          <arguments>run build</arguments>
          <inputDirectory>${project.basedir}</inputDirectory>
          <outputDirectory>${project.build.directory}/frontend</outputDirectory>
        </configuration>
      </execution>
    </executions>
  </plugin>
  

• 升级插件版本：尝试将frontend-maven-plugin升级到最新稳定版本，修复旧版本可能存在的重复执行bug。
• 验证增量构建逻辑：执行mvn clean install -DskipTests -X查看debug日志，确认Maven触发二次构建的具体原因，针对性调整插件配置。

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