多模块Maven项目：如何无需执行mvn install即可运行本地测试？

你的核心问题是Maven没有正确识别本地模块的依赖关联，导致它尝试从远程仓库拉取仅存在于本地的模块。以下是具体解决办法：

1. 确保模块依赖通过Reactor构建链关联 #

如果模块间存在依赖（比如util依赖core），必须在依赖方的pom.xml中声明正确的GAV，并且被依赖的模块要在父pom的<modules>列表中。这样Maven Reactor会自动按依赖顺序构建本地模块，无需提前install到本地仓库。

比如util模块的pom.xml中添加对core的依赖：

<dependencies>
    <dependency>
        <groupId>this-is-our-group</groupId>
        <artifactId>core</artifactId> <!-- 对应core模块的正确artifactId -->
        <version>${project.parent.version}</version> <!-- 继承父版本，避免硬编码不一致 -->
    </dependency>
</dependencies>

2. 校验父pom的模块路径配置 #

检查父pom中<modules>的相对路径是否与实际目录结构匹配。你的目录结构应该是这样的：

项目根目录/
├── parent/
│   └── pom.xml
├── core/
│   └── pom.xml
└── util/
    └── pom.xml

此时父pom中../core和../util的路径是正确的。如果路径错误，Maven找不到本地模块源码，就会转向远程仓库查找。

3. 使用Reactor模式执行构建命令 #

必须从父模块层面执行命令，让Maven自动管理模块构建顺序：

# 进入parent目录执行
mvn clean test

# 或者在项目根目录指定父pom执行
mvn clean test -f parent/pom.xml

单独构建子模块（比如直接进入util目录执行mvn test）会跳过Reactor依赖管理，导致Maven去本地仓库/远程仓库找依赖模块。

4. 统一模块版本，避免版本不一致 #

所有子模块的parent版本必须与父pom的<version>完全一致，建议用${project.parent.version}统一引用父版本，不要硬编码版本号。版本不一致会让Maven认为是不同的依赖，进而尝试从远程仓库拉取。

5. 清理本地仓库的旧依赖（可选） #

如果之前执行过mvn install，本地仓库中可能存在旧版本的模块，导致Maven优先使用仓库中的旧包而非本地源码模块。可以删除本地仓库中对应groupId的目录：

# Linux/macOS
rm -rf ~/.m2/repository/this-is-our-group/

# Windows
rd /s /q %USERPROFILE%\.m2\repository\this-is-our-group\

之后重新执行构建命令即可。

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