Maven多模块子模块在外部项目中无法解析依赖的解决方法

问题原因分析 #

从错误信息Could not find artifact com.test:common-module:jar:customer:pom:0.0.2-SNAPSHOT可以看出，Maven在解析common-module依赖时，错误将父项目customer当作依赖的标识信息，本质是子模块与父项目的继承配置不规范，或子模块未正确安装到本地仓库导致的。

解决方案步骤 #

1. 校验父项目（customer）的POM配置 #

父项目必须明确指定打包类型为pom，这是Maven多模块继承的核心要求：

<!-- customer父项目pom.xml -->
<groupId>com.test</groupId>
<artifactId>customer</artifactId>
<version>0.0.2-SNAPSHOT</version>
<packaging>pom</packaging>

<modules>
    <module>common-module</module>
    <module>service-module</module>
</modules>

同时，子模块common-module的POM中，parent配置必须正确关联父项目，本地开发时需设置relativePath（发布到仓库后可移除）：

<!-- common-module的pom.xml -->
<parent>
    <groupId>com.test</groupId>
    <artifactId>customer</artifactId>
    <version>0.0.2-SNAPSHOT</version>
    <relativePath>../pom.xml</relativePath>
</parent>

<artifactId>common-module</artifactId>
<!-- 无需重复指定groupId和version，自动继承父项目配置 -->
<packaging>jar</packaging>

2. 正确安装整个多模块项目到本地仓库 #

必须在父项目根目录执行Maven安装命令，确保父项目和子模块的POM都被同步到本地仓库：

mvn clean install

仅在common-module目录单独执行install会导致父项目POM未被安装，外部项目解析依赖时无法找到父项目元数据，从而抛出错误。

3. 修正外部项目（PROJECT 2）的依赖配置 #

引用common-module时，只需指定基本的groupId、artifactId和version，无需额外添加父项目相关配置：

<!-- PROJECT 2的pom.xml -->
<dependency>
    <groupId>com.test</groupId>
    <artifactId>common-module</artifactId>
    <version>0.0.2-SNAPSHOT</version>
</dependency>

避免在依赖中添加classifier或type="pom"，除非你需要引用父项目的POM而非子模块的jar包。

4. 清理缓存并重新构建 #

若上述步骤执行后仍有问题，强制更新快照依赖并清理本地缓存：

# 在父项目根目录执行
mvn clean install -U

# 在PROJECT 2目录执行
mvn clean compile

-U参数会强制Maven更新所有快照依赖，避免本地仓库中缓存的错误元数据干扰解析。

5. 验证本地仓库结构 #

检查本地Maven仓库（默认路径：~/.m2/repository/com/test）的目录结构，确保：

• 存在customer/0.0.2-SNAPSHOT/目录，且包含customer-0.0.2-SNAPSHOT.pom文件
• 存在common-module/0.0.2-SNAPSHOT/目录，且包含common-module-0.0.2-SNAPSHOT.jar和对应的POM文件

如果缺少父项目文件，说明之前的install操作未正确执行，需重新在父项目根目录执行install。

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