架构与系统设计 / 系统课时

依赖与版本管理

依赖与版本管理

本课完成企业支付平台的 Maven 依赖治理:由父工程统一锁定框架、中间件、日志和测试版本,业务模块只声明“使用什么”,不再各自决定“使用哪个版本”,从而减少升级冲突和环境差异。

学习目标

  • 理解父工程、BOM 与业务模块之间的职责边界
  • 使用 dependencyManagement 统一维护依赖版本
  • 通过有效 POM 和依赖树验证版本是否真正生效

为什么要集中管理版本

多模块项目最常见的问题不是“缺少依赖”,而是同一个组件被不同模块引入了不同版本。例如订单模块直接使用新版日志组件,而支付模块又通过中间件间接带入旧版,最终可能在启动或运行时出现 NoSuchMethodError。

父工程应负责版本与插件规则,业务模块只负责选择依赖。这样升级 Spring Boot、数据库驱动或测试框架时,只需修改一处,再统一执行构建验证。

父工程、依赖清单与业务模块的版本继承关系

建立父工程依赖清单

下面的父 POM 使用 Spring Boot 父工程提供基础插件规则,再通过属性和 dependencyManagement 集中管理中间件、日志扩展与测试组件版本。示例中的版本号应根据团队兼容性验证结果统一调整。

xml
<?xml version="1.0" encoding="UTF-8"?>
<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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.2.9</version>
        <relativePath/>
    </parent>

    <groupId>com.example.payment</groupId>
    <artifactId>payment-platform</artifactId>
    <version>1.0.0-SNAPSHOT</version>
    <packaging>pom</packaging>

    <modules>
        <module>payment-common</module>
        <module>payment-trade</module>
        <module>payment-gateway</module>
    </modules>

    <properties>
        <java.version>21</java.version>
        <spring-cloud.version>2023.0.3</spring-cloud.version>
        <spring-cloud-alibaba.version>2023.0.1.2</spring-cloud-alibaba.version>
        <mybatis-plus.version>3.5.7</mybatis-plus.version>
        <testcontainers.version>1.20.1</testcontainers.version>
    </properties>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>${spring-cloud.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
            <dependency>
                <groupId>com.alibaba.cloud</groupId>
                <artifactId>spring-cloud-alibaba-dependencies</artifactId>
                <version>${spring-cloud-alibaba.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
            <dependency>
                <groupId>com.baomidou</groupId>
                <artifactId>mybatis-plus-spring-boot3-starter</artifactId>
                <version>${mybatis-plus.version}</version>
            </dependency>
            <dependency>
                <groupId>org.testcontainers</groupId>
                <artifactId>junit-jupiter</artifactId>
                <version>${testcontainers.version}</version>
                <scope>test</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <build>
        <pluginManagement>
            <plugins>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-compiler-plugin</artifactId>
                    <version>3.13.0</version>
                </plugin>
            </plugins>
        </pluginManagement>
    </build>
</project>

dependencyManagement 只提供版本约束,不会自动把依赖加入模块。业务模块仍需显式声明所需组件,但通常不再写版本号。

xml
<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>com.baomidou</groupId>
        <artifactId>mybatis-plus-spring-boot3-starter</artifactId>
    </dependency>
    <dependency>
        <groupId>org.testcontainers</groupId>
        <artifactId>junit-jupiter</artifactId>
        <scope>test</scope>
    </dependency>
</dependencies>

生效行为:业务模块中的 MyBatis-Plus 和 Testcontainers 会继承父工程锁定的版本;Spring Boot Starter 则继承 Spring Boot 父工程维护的依赖清单。

验证依赖版本

在项目根目录执行有效 POM 与依赖树检查,避免只看源码 POM 就误判版本已经生效。

bash
mvn -pl payment-trade help:effective-pom -Doutput=effective-pom.xml
mvn -pl payment-trade dependency:tree -Dincludes=com.baomidou:mybatis-plus-spring-boot3-starter

预期结果

text
[INFO] Building payment-trade 1.0.0-SNAPSHOT
[INFO] com.example.payment:payment-trade:jar:1.0.0-SNAPSHOT
[INFO] \- com.baomidou:mybatis-plus-spring-boot3-starter:jar:3.5.7:compile
[INFO] BUILD SUCCESS

实际日志中的耗时和本地仓库路径可能不同。若依赖树出现多个版本,先查找引入旧版本的上游依赖,再使用排除规则处理;不要直接在多个业务模块里分别覆盖版本。

版本升级的控制原则

升级应以“一个版本入口、一次完整验证”为原则。先在父工程修改版本,再依次执行编译、单元测试、集成测试和依赖树检查。涉及数据库驱动、序列化、日志门面或云组件时,还要核对兼容矩阵,避免仅凭构建成功判断运行安全。

不要把所有依赖都放进父工程的普通 dependencies。这样会让每个子模块被动引入不需要的组件,增加包体积、启动时间和冲突概率。父工程更适合管理版本,公共模块才适合承载真正共享的代码与依赖。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

依赖与版本管理

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通