Spring Boot项目因frontend-maven-plugin构建失败，求解决方案

问题背景 #

使用Spring Boot 2.3.0 + Java 11，通过com.github.eirslett:frontend-maven-plugin:1.6处理React项目构建时，抛出LifecycleExecutionException，执行yarn run build任务失败。

排查与修复方案 #

1. 升级frontend-maven-plugin版本 #

1.6版本属于旧版本，对Node 16的兼容性存在已知问题。建议升级到最新稳定版（如1.15.0），修改pom.xml中的插件版本：

<plugin>
    <groupId>com.github.eirslett</groupId>
    <artifactId>frontend-maven-plugin</artifactId>
    <version>1.15.0</version>
    <!-- 原有配置保持不变 -->
</plugin>

2. 验证Node与Yarn版本兼容性 #

虽然Node 16.12.0和Yarn 1.22.19理论上兼容，但部分环境下可能存在适配问题。可以尝试：

• 切换Node到LTS版本（如v14.21.3或v18.17.1）
• 升级Yarn到1.x最新稳定版（如v1.22.21）
  修改pom.xml中对应的版本配置后重新执行构建。

3. 清理缓存与构建产物 #

本地缓存或残留的构建文件可能导致冲突，执行以下操作：

• 执行Maven清理：mvn clean
• 进入frontend目录，执行：

  yarn cache clean
  rm -rf node_modules yarn.lock
  

• 重新执行Maven构建：mvn install

4. 手动执行React构建，定位具体错误 #

Maven抛出的异常仅显示顶层错误，具体的React构建问题被隐藏。直接在frontend目录执行：

yarn run build

查看控制台输出的具体错误（如依赖缺失、语法错误、资源路径问题等），针对性修复。

5. 开启插件详细日志，排查执行细节 #

在frontend-maven-plugin的configuration中添加verbose配置，输出更详细的Yarn执行日志：

<plugin>
    <groupId>com.github.eirslett</groupId>
    <artifactId>frontend-maven-plugin</artifactId>
    <version>1.6</version>
    <configuration>
        <workingDirectory>frontend</workingDirectory>
        <installDirectory>target</installDirectory>
        <verbose>true</verbose> <!-- 添加此行 -->
    </configuration>
    <!-- 原有executions配置保持不变 -->
</plugin>

重新构建后，通过详细日志定位任务执行失败的具体环节。

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