为何子POM未使用父POM指定的Dubbo 3.1.9版本，却下载2.7.4.1？

问题背景 #

父POM代码 #

<modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>SpringCloudDemo</artifactId>
<version>0.0.1-SNAPSHOT</version>
<name>SpringCloudDemo</name>
<description>SpringCloudDemo</description>
<packaging>pom</packaging>

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.apache.dubbo</groupId>
            <artifactId>dubbo-spring-boot-starter</artifactId>
            <version>${spring-boot-dubbo.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        <dependency>
            <groupId>org.apache.dubbo</groupId>
            <artifactId>dubbo</artifactId>
            <version>${spring-boot-dubbo.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        <dependency>
            <groupId>org.apache.dubbo</groupId>
            <artifactId>dubbo-registry-nacos</artifactId>
            <version>${spring-boot-dubbo-nacos.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

子POM代码 #

<parent>
    <groupId>com.example</groupId>
    <artifactId>SpringCloudDemo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <relativePath>../pom.xml</relativePath>
</parent>

<dependencies>
    <dependency>
        <groupId>org.apache.dubbo</groupId>
        <artifactId>dubbo-spring-boot-starter</artifactId>
    </dependency>
    <dependency>
        <groupId>org.apache.dubbo</groupId>
        <artifactId>dubbo</artifactId>
    </dependency>
    <!-- Nacos依赖 -->
    <dependency>
        <groupId>org.apache.dubbo</groupId>
        <artifactId>dubbo-registry-nacos</artifactId>
        <version>3.0.1</version>
    </dependency>
</dependencies>

实际构建时，子项目下载的是Dubbo 2.7.4.1版本，而非父POM中预期的3.1.9版本。

原因分析 #

1. 父POM版本变量未定义：父POM中使用了${spring-boot-dubbo.version}和${spring-boot-dubbo-nacos.version}变量，但未在<properties>块中明确赋值为3.1.9。Maven无法解析变量时，会通过依赖传递自动获取版本，大概率引入旧版本。
2. 子POM硬编码版本冲突：子POM中给dubbo-registry-nacos指定了3.0.1版本，该版本内部依赖Dubbo 2.7.4.1。根据Maven依赖调解规则，冲突场景下会优先选择路径更短或先声明的版本，最终导致旧版本被使用。
3. Import Scope生效异常：父POM通过<scope>import</scope>导入Dubbo的POM，但如果导入的POM版本不存在、或其内部依赖管理未正确覆盖Dubbo核心版本，会导致子项目无法继承到预期版本。

解决方案 #

1. 补全父POM版本变量 #

在父POM的<properties>中明确指定统一的Dubbo版本：

<properties>
    <spring-boot-dubbo.version>3.1.9</spring-boot-dubbo.version>
    <spring-boot-dubbo-nacos.version>3.1.9</spring-boot-dubbo-nacos.version>
</properties>

Dubbo 3.x生态中，核心包、starter包及注册中心扩展包的版本必须保持一致，避免跨版本依赖冲突。

2. 移除子POM中的硬编码版本 #

子POM中dubbo-registry-nacos的版本应从父POM的依赖管理中继承，不要硬编码：

<!-- Nacos依赖 -->
<dependency>
    <groupId>org.apache.dubbo</groupId>
    <artifactId>dubbo-registry-nacos</artifactId>
</dependency>

3. 排查依赖树定位冲突 #

执行Maven命令查看Dubbo的依赖来源，精准定位旧版本的引入路径：

mvn dependency:tree -Dincludes=org.apache.dubbo:dubbo

若发现其他依赖引入了Dubbo 2.7.4.1，可在对应依赖中添加排除规则：

<dependency>
    <!-- 引入冲突的依赖 -->
    <groupId>xxx</groupId>
    <artifactId>xxx</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.apache.dubbo</groupId>
            <artifactId>dubbo</artifactId>
        </exclusion>
    </exclusions>
</dependency>

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