Maven 多模块项目，仅子模块存在依赖错误

问题分析 #

从你的描述和项目结构来看，核心矛盾点在于：

• 根目录构建时，Maven会通过Reactor构建机制按依赖顺序先构建BOM模块my-project-dependencies，此时BOM的版本定义会被加载到构建上下文，因此所有子模块都能正确解析依赖版本。
• 单独构建子模块时，Maven需要从本地/远程仓库获取父模块的dependencyManagement配置以及BOM模块的定义。如果BOM模块未被安装到本地仓库，Maven会 fallback 到仓库中缓存的旧版本依赖（这里是Spring Boot 2.3.9.RELEASE），导致版本解析错误。

解决方案 #

1. 先安装BOM模块到本地仓库 #

单独构建子模块前，必须确保BOM模块my-project-dependencies已被安装到本地Maven仓库，这样Maven才能正确读取其版本定义。

在父项目根目录执行：

mvn clean install -pl my-project-dependencies -am

参数说明：

• -pl my-project-dependencies：指定仅构建BOM模块
• -am：自动构建该模块依赖的前置模块（如果BOM无额外依赖可省略）

执行完成后，再进入子模块my-project-unique执行mvn clean package，依赖版本应能正确解析为3.5.10。

2. 验证BOM与父模块的配置正确性 #

父模块parent/pom.xml需正确导入BOM模块

确保dependencyManagement中通过import方式引入自定义BOM：

<dependencyManagement>
    <dependencies>
        <!-- 导入自定义BOM -->
        <dependency>
            <groupId>你的项目GroupId</groupId>
            <artifactId>my-project-dependencies</artifactId>
            <version>你的项目版本号</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

BOM模块my-project-dependencies/pom.xml需正确导入Spring Boot官方BOM

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>你的项目GroupId</groupId>
        <artifactId>parent</artifactId>
        <version>你的项目版本号</version>
    </parent>
    <artifactId>my-project-dependencies</artifactId>
    <packaging>pom</packaging>

    <dependencyManagement>
        <dependencies>
            <!-- 导入Spring Boot官方BOM -->
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-dependencies</artifactId>
                <version>3.5.10</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>
</project>

3. 检查子模块是否存在版本覆盖 #

确保子模块my-project-unique/pom.xml中没有显式引入旧版本依赖，也没有覆盖父模块的版本定义：

<!-- 错误示例：禁止在子模块中硬编码旧版本 -->
<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter</artifactId>
        <version>2.3.9.RELEASE</version> <!-- 需删除该版本指定 -->
    </dependency>
</dependencies>

4. 清理Maven本地仓库缓存 #

如果本地仓库存在旧版本的BOM或Spring Boot依赖缓存，可能导致Maven解析异常。执行以下命令清理：

# 删除Spring Boot相关缓存
rm -rf ~/.m2/repository/org/springframework/boot
# 删除自定义BOM缓存
rm -rf ~/.m2/repository/你的项目GroupId/my-project-dependencies

清理完成后重新安装BOM模块，再尝试单独构建子模块。

关键原理补充 #

• Reactor构建：根目录构建时，Maven会自动分析模块依赖关系，按顺序构建所有前置模块（如BOM），此时版本定义会被加载到当前构建上下文，无需依赖本地仓库。
• 单独构建依赖：单独构建子模块时，Maven完全依赖本地/远程仓库的已安装模块，若BOM未被安装，会触发依赖版本的 fallback 逻辑（使用仓库中存在的旧版本）。

如果以上方案仍未解决问题，请补充以下信息用于进一步排查：

1. 父模块pom.xml中dependencyManagement的完整配置
2. my-project-dependencies/pom.xml的完整内容
3. 子模块pom.xml的完整内容