IntelliJ构建正常、Maven编译成功但install失败的多模块项目问题

我有一个多模块Spring Boot项目，结构如下：

parent-project/
│
├── pom.xml                  <- 父POM
├── module-a/
│   └── pom.xml              <- module A 依赖 modules B 和 C
├── module-b/
│   └── pom.xml              <- module B 依赖 module C
└── module-c/
    └── pom.xml              <- module C

所有模块版本均为0.3.0-SNAPSHOT，执行mvn clean install时，模块A报错package from.module.B does not exist，无法识别模块B；但执行mvn compile构建成功，IntelliJ和Cursor都能正常识别依赖、构建运行项目，本地Maven版本和IDE内置版本都是3.9.9。

模块的maven-compiler-plugin配置统一为：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <configuration>
        <source>21</source>
        <target>21</target>
    </configuration>
</plugin>

已尝试检查包名/版本、删除本地仓库、重新导入项目、清除缓存等操作，问题仍未解决。

1. 调整父POM的模块构建顺序 #

Maven多模块构建会严格按照父POM中<modules>标签的顺序执行。如果module-a在module-b之前声明，执行install时，module-a构建阶段module-b还未被安装到本地仓库，就会出现依赖找不到的问题。

修改父POM的模块顺序，确保依赖模块优先构建：

<modules>
    <module>module-c</module>
    <module>module-b</module>
    <module>module-a</module>
</modules>

2. 检查模块依赖的scope配置 #

确认module-a对module-b的依赖scope是否正确，默认compile即可，若误设为provided或其他scope，会导致install阶段无法正常引用依赖。

module-a的pom.xml中依赖配置应类似：

<dependency>
    <groupId>你的项目groupId</groupId>
    <artifactId>module-b</artifactId>
    <version>0.3.0-SNAPSHOT</version>
    <!-- scope默认compile，可省略 -->
</dependency>

3. 处理Spring Boot插件的repackage行为 #

如果非启动模块（如module-b、module-c）使用了spring-boot-maven-plugin的repackage目标，会生成可执行jar，其内部结构与普通依赖jar不同，导致其他模块无法正确引用。

对于非启动模块，禁用repackage功能：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <skip>true</skip>
    </configuration>
</plugin>

或者配置生成双jar（普通依赖jar+可执行jar）：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <executions>
        <execution>
            <id>repackage</id>
            <goals>
                <goal>repackage</goal>
            </goals>
            <configuration>
                <classifier>exec</classifier>
            </configuration>
        </execution>
    </executions>
</plugin>

4. 使用Maven多模块构建参数 #

执行install时，加上-am（自动构建依赖模块）和-pl（指定目标模块）参数，确保依赖模块先被安装：

mvn clean install -pl module-a -am

5. 确认模块打包类型 #

检查非启动模块的打包类型是否为jar（默认值），若误设为pom，则不会生成可被依赖的jar文件。

以module-b为例，pom.xml中需确保：

<packaging>jar</packaging>

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