多模块Spring Boot Maven项目指定模块构建时依赖找不到问题排查

你遇到的是多模块Maven项目里典型的依赖构建顺序问题——虽然已经在module2中添加了module1的依赖，但直接指定module2执行命令时，Maven可能没先完成module1的构建，导致module2打包时找不到它的类。下面是几个具体的排查和解决方向：

1. 核对module2的依赖配置是否准确 #

先确认module2的pom.xml里对module1的依赖声明完全正确，应该是类似这样的结构：

<dependencies>
    <dependency>
        <groupId>com.example</groupId>
        <artifactId>module1</artifactId>
        <version>0.0.1-SNAPSHOT</version>
    </dependency>
</dependencies>

要保证groupId、artifactId、version和父项目、module1的pom配置完全一致，没有拼写或版本号错误。

2. 让Maven自动构建依赖模块 #

你当前执行的命令mvn clean package -pl module2 spring-boot:run仅指定了构建module2，但Maven默认不会自动处理未指定的依赖模块。可以加上-am参数，让Maven同时构建module2的所有依赖模块：

mvn clean package -pl module2 -am spring-boot:run

-am是"also-make"的缩写，它会触发Maven先构建module2依赖的所有模块（也就是module1），这样module2打包时就能找到module1的编译类了。

3. 检查父项目的modules配置 #

确认父项目的pom.xml里已经正确声明了所有子模块：

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

如果module1没被加入父项目的modules列表，Maven在多模块构建场景下无法识别它的存在，自然也没法自动处理依赖关系。

4. 确认module1的打包类型 #

如果module1是普通Java模块，它的pom.xml打包类型应该是<packaging>jar</packaging>（默认就是jar，无需特意声明，但如果被改成了pom等其他类型就会出问题）。只有jar类型的模块才能被其他模块作为依赖引用。

5. 先全局构建再单独运行module2 #

如果上面的方法都没解决问题，可以先在父项目根目录执行完整的构建，把所有模块安装到本地Maven仓库：

mvn clean install

之后再单独运行module2：

mvn -pl module2 spring-boot:run

这样module2就能从本地Maven仓库中找到module1的jar包，不会再出现找不到类的情况。

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