Maven多模块项目构建报错：无法解析子模块module2依赖如何解决

解决方案 #

你遇到的是Maven多模块项目常见的跨模块依赖找不到问题，按以下步骤排查修复即可：

• 步骤1：检查父工程模块声明
  确认父工程pom.xml中已正确包含所有子模块，且配置顺序无异常，示例配置如下：

  <modules>
      <module>module2</module>
      <module>module1</module>
      <module>module3</module>
  </modules>
  

  注：模块建议按依赖顺序声明，被依赖的module2放在依赖它的module1之前，Maven会自动按依赖顺序构建。

• 步骤2：将被依赖模块安装到本地仓库
  新增跨模块依赖后，需要先将被依赖的module2构建安装到本地Maven仓库，在父工程根目录执行以下命令即可：

  mvn clean install -pl module2
  

• 步骤3：正确执行构建命令
  如果需要单独构建module1，需要加-am（also make）参数让Maven自动构建其依赖的所有子模块，命令如下：

  mvn clean install -pl module1 -am
  

  如果直接构建父工程，正常执行mvn clean install即可，只要父工程正确声明了所有模块，会自动按顺序构建所有子模块。
• 步骤4：核对基础配置一致性
  检查以下配置是否匹配：
  • module2的pom.xml中的groupId、artifactId、version和module1中声明的依赖完全一致，无拼写错误
  • module2的打包类型为默认的jar，未被修改为pom等其他类型
  • 如果父工程使用dependencyManagement统一管理依赖版本，确认子模块版本和父工程中声明的版本一致
• 步骤5：刷新IDE缓存（IntelliJ环境）
  如果是在IDEA中执行构建报错，打开右侧Maven面板，右键父工程选择「Reload project」刷新依赖缓存，排除IDE缓存异常导致的依赖识别问题。

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