Eclipse嵌入式Maven执行mvn clean install报错求助

错误信息 #

Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:3.6.3:jar (attach-javadocs) on project toolbox-service-helper: Execution attach-javadocs of goal org.apache.maven.plugins:maven-javadoc-plugin:3.6.3:jar failed: Maven home is set to: '/Users/paulmarcelinbejan/Develop/Personal/projects/ToolBox/EMBEDDED' which is not a directory

问题分析 #

报错核心是Maven home指向的EMBEDDED路径并非有效目录，且仅toolbox-service-helper模块构建失败，说明该模块的Maven运行时配置存在异常，或Eclipse全局Maven配置有无效条目。

解决步骤 #

• 检查Eclipse全局Maven Runtime配置

  1. 打开Eclipse，依次点击Window > Preferences > Maven > Installations
  2. 查看已配置的Maven安装列表，删除指向/Users/paulmarcelinbejan/Develop/Personal/projects/ToolBox/EMBEDDED的无效条目
  3. 保留本地正确的Maven安装路径（例如/usr/local/apache-maven-xxx这类实际存在的目录），选中该有效路径后点击Apply and Close

• 修正单个模块的Maven配置

  1. 右键toolbox-service-helper模块，选择Properties > Maven
  2. 在Maven Runtime选项中，确认是否使用全局默认配置；若该模块单独指定了无效路径，改为Use default Maven runtime或手动选择正确的本地Maven安装
  3. 点击Apply and Close

• 清理并重新构建

  1. 右键该模块，选择Maven > Clean清理缓存
  2. 执行Maven > Install重新构建；若暂时不需要生成javadoc，也可在终端进入模块目录执行mvn clean install -Dmaven.javadoc.skip=true快速验证配置是否修复

• 检查插件配置（可选）
  打开模块的pom.xml，查看maven-javadoc-plugin的配置段，若存在手动指定Maven home的参数，直接移除或修正路径

内容的提问来源于stack exchange，提问作者Paul Marcelin Bejan