Maven多模块子模块单独构建依赖版本错误问题排查

在父项目根目录构建时，Maven会按顺序构建所有模块（包括BOM模块）并将其安装到本地仓库，子模块因此能正确读取BOM中的版本规则。但单独构建子模块时，若BOM模块未提前安装到本地仓库，Maven无法找到父项目依赖的BOM版本定义，会 fallback 到依赖的默认旧版本（2.3.9.RELEASE）。

1. 提前安装父项目与BOM模块到本地仓库 #

在父项目根目录执行以下命令，确保BOM模块和父POM被正确安装到本地Maven仓库：

mvn clean install -DskipTests

完成后，子模块单独构建时就能读取到正确的版本规则。

2. 校验子模块的Parent配置 #

确保子模块pom.xml中的parent节点完全匹配父项目，且relativePath配置准确（若父POM不在子模块的直接上级目录，需指定正确路径）：

<parent>
    <groupId>你的项目GroupId</groupId>
    <artifactId>parent</artifactId>
    <version>父项目版本号</version>
    <relativePath>../pom.xml</relativePath> <!-- 路径需准确指向父POM -->
</parent>

若relativePath错误，Maven会从本地仓库查找旧的父POM，可能不包含正确的BOM依赖配置。

3. 确认BOM模块与父项目的依赖管理配置 #

BOM模块（my-project-dependencies/pom.xml）需正确导入Spring Boot BOM： #

<dependencyManagement>
    <dependencies>
        <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>

父项目（parent/pom.xml）需正确引入自定义BOM模块： #

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>你的项目GroupId</groupId>
            <artifactId>my-project-dependencies</artifactId>
            <version>${project.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

4. 清理Maven缓存并强制更新 #

若本地仓库存在旧依赖缓存，执行以下命令强制更新：

mvn clean install -U

-U参数会强制Maven更新快照依赖，确保读取最新的版本定义。

进入子模块目录，执行：

mvn dependency:tree

检查输出中spring-boot-starter等依赖的版本是否为3.5.10。若仍有问题，执行mvn help:effective-pom查看生效的POM文件，确认dependencyManagement节点中是否包含正确的BOM版本规则。

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