构建与依赖 / 系统课时

使用 versions 插件检查更新

使用 versions 插件检查更新

依赖和构建插件长期不升级会累积兼容性与安全维护成本,但直接改到“最新版本”同样可能引入破坏性变化。本课使用 Versions Maven Plugin 2.22.0 只做扫描,分别检查依赖、插件、版本属性和父 POM,再说明当前项目自身版本应如何处理。

学习目标

  • 使用 Versions Maven Plugin 查询依赖、插件、属性和父 POM 的可用更新。
  • 区分“只显示更新”的目标与会修改 pom.xml 的目标。
  • 根据 major、minor、incremental 更新范围控制扫描结果。

先固定插件版本再执行扫描

截至 Versions Maven Plugin 2.22.0,其运行要求为 Maven 3.6.3+、JDK 8+。团队项目应固定插件版本,避免不同时间执行相同命令却因为默认解析到不同插件版本而得到不同规则或行为。

把下面配置加入 <build><pluginManagement><plugins>。如果项目会直接从生命周期或命令行使用该插件,也可以在 <build><plugins> 中声明它。

片段示例:以下 <plugin> 依赖现有 POM 的 <build><pluginManagement><plugins> 上下文。

xml
<plugin>
  <groupId>org.codehaus.mojo</groupId>
  <artifactId>versions-maven-plugin</artifactId>
  <version>2.22.0</version>
</plugin>

配置生效后,可用全限定目标验证固定版本,而不依赖 Maven 的插件前缀解析。

bash
mvn org.codehaus.mojo:versions-maven-plugin:2.22.0:display-dependency-updates

预期结果

text
构建日志中出现依赖更新报告;如果所有依赖都已是当前规则下的最新版本,则不会列出可升级依赖。命令只读取并报告,不修改 pom.xml。

实际报告中的构件名和版本取决于当前项目与远程仓库,因此不能预先固定成某一组数字。

分别检查依赖插件和属性

display-dependency-updates 检查项目依赖及依赖管理中的可用更新;display-plugin-updates 检查构建插件;display-property-updates 检查那些被用于控制构件版本的属性。把三类分开执行,比一次看到混合结果更容易决定升级顺序。

bash
mvn versions:display-dependency-updates
mvn versions:display-plugin-updates
mvn versions:display-property-updates

预期结果

text
三条命令分别输出依赖、插件和版本属性的更新报告,且都不会修改 pom.xml。实际候选版本随仓库内容和执行时间变化。

如果父 POM 也需要检查,使用 display-parent-updates。这与“检查当前项目自己的版本”不是一回事:父 POM 是外部或上层构件,有仓库中的候选版本;当前项目版本通常由团队发布流程决定,不存在插件自动判断“你下一版应该是多少”的可靠依据。

bash
mvn versions:display-parent-updates

预期结果

text
如果当前 parent 有符合规则的更高版本,报告会列出候选版本;没有候选时不会要求修改项目版本。

用更新范围过滤不想看的大版本

默认情况下,依赖更新检查允许 incremental、minor 和 major 更新。维护分支若只接受补丁级升级,可以关闭 minor 和 major;当 allowMinorUpdates=false 时 major 也会被关闭。

bash
mvn versions:display-dependency-updates -DallowMinorUpdates=false -DallowMajorUpdates=false

预期结果

text
报告只考虑当前版本序列允许的 incremental 更新,不把 minor 或 major 候选作为升级建议列出。

例如项目从 2.6.3 维护到 2.6.x 时,这种过滤比看到 3.x 候选更有操作价值。对插件更新也应先确认 Maven 和 JDK 前置要求,因为新插件版本可能提高最低运行环境。

项目自身版本要显式决定

Versions 插件可以修改当前项目版本,但“修改”与“发现一个应该升级到的项目版本”是两件事。确定下一个版本号后,可以使用 versions:set 显式写入新版本;使用 CI Friendly 的 revision 时,则更适合修改 revision 属性或由构建参数覆盖。

对于普通固定版本 POM,下面命令会把项目版本改为指定值,因此执行前应确保工作区干净并准备检查差异。

bash
mvn versions:set -DnewVersion=1.5.0-SNAPSHOT

预期结果

text
当前项目及插件能够处理的相关模块版本被更新为 1.5.0-SNAPSHOT,pom.xml 产生可审查的版本变更。

检查更新时优先使用 display-* 目标,因为它们不会修改 POM;真正升级时再逐类变更、运行测试并查看版本控制差异。这样可以把“发现候选版本”和“接受升级风险”分成两个可验证步骤。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 versions 插件检查更新

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

登录哪都通