maven依赖版本管理

Maven 依赖版本管理：统一控制与高效维护

在多模块项目中，依赖版本的不一致是导致冲突和构建失败的常见原因。Maven 提供了 dependencyManagement 机制，通过集中式配置实现依赖版本的统一管理，确保项目中所有模块使用一致的依赖版本。

`dependencyManagement` 的核心作用

dependencyManagement 是 Maven 中用于集中管理依赖版本的标签，它的核心价值在于：

版本统一：所有模块使用相同的依赖版本，避免因版本差异导致的冲突（如类找不到、方法不兼容）。
简化配置：子模块引入依赖时无需指定版本，直接继承父项目的版本定义。
灵活管控：仅声明版本，不实际引入依赖，子模块可按需选择是否引入。

配置详解

版本属性化（`properties`）

将版本号定义在 <properties> 中，便于集中修改和维护：

<properties>
    <spring-boot.version>2.2.2.RELEASE</spring-boot.version>
    <mysql.version>5.1.48</mysql.version>
</properties>

使用 ${属性名} 引用版本，例如：

<version>${spring-boot.version}</version>

导入外部依赖管理（`import` 范围）

对于 Spring Boot、Spring Cloud 等生态，可直接导入其提供的依赖管理 POM，避免手动声明每个组件的版本：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-dependencies</artifactId>
    <version>${spring-boot.version}</version>
    <type>pom</type>
    <scope>import</scope> <!-- 关键：导入外部POM中的依赖管理配置 -->
</dependency>

原理：spring-boot-dependencies 内部已定义了所有 Spring Boot 组件的版本，导入后可直接使用这些组件而无需指定版本。

自定义依赖版本

对于项目特有的依赖（如数据库驱动、连接池），在 dependencyManagement 中声明其版本：

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>${mysql.version}</version>
</dependency>

子模块中的使用方式

子模块继承父项目后，引入依赖时无需指定版本，直接继承父项目的配置：

<!-- 子模块POM -->
<project>
    <parent>
        <groupId>com.example</groupId>
        <artifactId>parent-project</artifactId>
        <version>1.0.0</version>
    </parent>

    <dependencies>
        <!-- 无需指定version，自动使用父项目中声明的5.1.48 -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
        </dependency>

        <!-- 无需指定version，自动使用spring-boot-dependencies中定义的版本 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <!-- 测试依赖，继承版本和scope -->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <!-- 无需指定version和scope，继承父项目的test范围 -->
        </dependency>
    </dependencies>
</project>

版本覆盖策略

在某些场景下，子模块可能需要使用与父项目不同的版本，可通过显式声明版本覆盖父项目配置：

<!-- 子模块中覆盖版本 -->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.30</version> <!-- 覆盖父项目的5.1.48 -->
</dependency>

注意：尽量避免随意覆盖版本，除非有明确的兼容性需求，否则可能引入版本冲突。

与 `dependencies` 的区别

特性	`dependencyManagement`	`dependencies`
作用	声明依赖版本，不实际引入	实际引入依赖，若未指定版本则继承父项目
范围	仅影响子模块的依赖版本	直接影响当前项目的依赖引入
传递性	不传递依赖，仅传递版本信息	依赖会传递给子项目
适用场景	多模块项目统一版本管理	单个项目或子模块中实际引入依赖