构建与依赖 / 系统课时
dependencyManagement 的作用
dependencyManagement 的作用
dependencyManagement 用来集中规定依赖的版本和默认规则,但它本身不会把依赖加入项目。掌握这一点后,你可以让多个模块共享同一版本,又避免父 POM 把所有依赖强行塞进每个子模块。
学习目标
- 区分
dependencyManagement与dependencies的职责。 - 在父 POM 中统一依赖版本,并让子模块省略
version。 - 用 Maven 依赖树验证最终采用的版本。
先区分“管理版本”和“引入依赖”
假设项目有 6 个模块,其中 4 个都使用 commons-lang3。把版本写进 dependencyManagement,只是在模型里声明“如果某个模块需要它,默认使用 3.14.0”;真正让 JAR 进入编译类路径的仍然是 dependencies。
| 配置位置 | 会直接引入依赖 | 可以统一版本 | 子模块是否还要声明依赖 |
|---|---|---|---|
dependencies |
会 | 可以,但会同时引入 | 不一定,父依赖通常会被继承 |
dependencyManagement |
不会 | 会 | 要,需要时在 dependencies 中声明 |
根目录父 POM 可以这样集中管理版本:
<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>
<groupId>com.example</groupId>
<artifactId>demo-parent</artifactId>
<version>1.0.0</version>
<packaging>pom</packaging>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-lang3</artifactId>
<version>3.14.0</version>
</dependency>
</dependencies>
</dependencyManagement>
</project>子模块只声明“我要这个依赖”,不再重复版本:
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-lang3</artifactId>
</dependency>这样 4 个使用该库的模块都会采用 3.14.0,而另外 2 个没有声明它的模块不会凭空多出这项依赖。
用依赖树确认最终版本
在包含子模块 pom.xml 的目录执行:
mvn dependency:tree -Dincludes=org.apache.commons:commons-lang3预期输出中应出现 3.14.0;时间、插件日志和路径等动态信息可能不同。
[INFO] com.example:app:jar:1.0.0
[INFO] \- org.apache.commons:commons-lang3:jar:3.14.0:compile如果这里没有 commons-lang3,说明子模块只受到了版本管理,却没有在 dependencies 中真正声明依赖。如果出现了其他版本,应继续检查子模块是否显式写了 version,或是否有更近层级的 dependencyManagement 覆盖了父配置。
版本覆盖要按层级判断
dependencyManagement 是默认规则,不是不可修改的锁。子模块显式声明 <version>3.13.0</version> 时,该直接依赖会按子模块写出的版本解析;子模块也可以在自己的 dependencyManagement 中重新管理同一坐标。
一个常见做法是:父 POM 管理公共版本,业务模块只在确有兼容性理由时覆盖,并在代码评审里说明原因。例如 6 个模块统一用 3.14.0,只有旧接口模块因第三方兼容要求暂时固定 3.13.0,这种偏离应是可追踪的例外。
什么时候应该放进 dependencyManagement
适合放进去的是多个模块可能共享、且版本需要统一的依赖,例如测试框架、日志 API、JSON 库和公司内部公共组件。一个 10 模块项目里,如果 7 个模块都用同一 JSON 库,把版本集中管理可以把升级操作从 7 处改成 1 处。
不适合的是只被单个模块临时使用、且没有跨模块版本协调需求的依赖。此时直接在该模块 dependencies 中写版本更直观。判断标准很简单:需要“统一版本”时用 dependencyManagement,需要“真正引入”时用 dependencies,两者可以同时存在但职责不能混淆。