架构与系统设计 / 系统课时
依赖与版本管理
依赖与版本管理
本课完成企业支付平台的 Maven 依赖治理:由父工程统一锁定框架、中间件、日志和测试版本,业务模块只声明“使用什么”,不再各自决定“使用哪个版本”,从而减少升级冲突和环境差异。
学习目标
- 理解父工程、BOM 与业务模块之间的职责边界
- 使用
dependencyManagement统一维护依赖版本 - 通过有效 POM 和依赖树验证版本是否真正生效
为什么要集中管理版本
多模块项目最常见的问题不是“缺少依赖”,而是同一个组件被不同模块引入了不同版本。例如订单模块直接使用新版日志组件,而支付模块又通过中间件间接带入旧版,最终可能在启动或运行时出现 NoSuchMethodError。
父工程应负责版本与插件规则,业务模块只负责选择依赖。这样升级 Spring Boot、数据库驱动或测试框架时,只需修改一处,再统一执行构建验证。

建立父工程依赖清单
下面的父 POM 使用 Spring Boot 父工程提供基础插件规则,再通过属性和 dependencyManagement 集中管理中间件、日志扩展与测试组件版本。示例中的版本号应根据团队兼容性验证结果统一调整。
<?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 只提供版本约束,不会自动把依赖加入模块。业务模块仍需显式声明所需组件,但通常不再写版本号。
<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 就误判版本已经生效。
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预期结果
[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。这样会让每个子模块被动引入不需要的组件,增加包体积、启动时间和冲突概率。父工程更适合管理版本,公共模块才适合承载真正共享的代码与依赖。