New Hot

Maven 3.10.1 发布:兼容 Maven 4 解析器,修复 3.10.0 回归并精简启动开销

Maven构建工具JVM依赖解析版本更新

Maven 3.10.1 发布,作为 3.10.0 的缺陷修复版本,回归被一并修正,并与 Maven 4 共用 Resolver 2.0 解析器。版本还带来可选 profile 语法、彩色输出与更严格的 POM 校验,从 3.9.x 迁移前需要评估。

Maven 3.10.1 修复 3.10.0 回归并共用 Resolver 2.0

Maven 3.10.1 是 3.10.0 的缺陷修复版本,重点修回归并与 Maven 4 共用 Resolver 2.0。 版本还补齐了若干向 Maven 4 靠拢的能力。

与 Maven 4 对齐

官方说明这一代的主要动机是让 Maven 3 与 4 的解析器版本一致,3.10 起使用 Resolver 2.0。官方原文称:“Maven 3.10.1 is a bugfix release for 3.10.0.”(来源:Apache Maven 官方发布说明)

新特性与更轻的启动

新增可选 profile 语法 -P ?id,与 Maven 4 一致,同一条命令可用于两个版本;基于 maven-api-core 4.x 的插件可以注入 MessageBuilderFactory 获得彩色输出。JLine 终端栈被移除,彩色输出改为普通 ANSI 转义码,3.10.0 引入的启动开销随之消失。Maven 3.10.1 仍要求 Java 8 或以上。

迁移 3.9.x 的注意点

POM 校验级别提高:重复的依赖或插件声明、版本里的非法字符、格式错误的快照版本、保留或非法的仓库 id 都会让构建失败,可用 -Dmaven.resolver.validation=off 临时关闭。依赖 classpath 顺序从深度优先改为层级优先,可用 -Daether.system.dependencyVisitor=preOrder 恢复。

POM 校验变严与 classpath 层级优先带来的影响

从 3.9.x 升级的团队最容易遇到构建失败,长期停在旧版本的存量项目需要预留清理时间。

POM 要先清理

原先只告警的问题现在变成错误,仓库里堆积的重复声明会直接卡住构建。从官方描述看,这是有意推动用户清理 POM,而不是临时收紧。

依赖顺序可能影响运行

classpath 改为层级优先后,依赖冲突时的实际加载顺序会变。若项目依赖隐式的深度优先顺序,升级后可能出现类加载差异,需要保留开关验证。

构建可复现性提升

Super POM 移除了已弃用的 release profile 与插件管理,默认设置 UTF-8 编码与构建输出时间戳,可复现构建默认启用。JVM 版本配套可以对照 OpenJDK 27 的 GA 说明,同期的另一套构建工具见 Gradle 9.9.1 更新。

从 3.9.x 迁移需先清理 POM 再升级 3.10.1

新项目可以直接使用 3.10.1;从 3.9.x 迁移的存量项目建议先清理 POM 再升级。

怎么升级

替换 Maven 安装包或 wrapper 配置到 3.10.1 即可,插件版本按官方插件列表单独评估。

已知问题

构建目录与本地仓库不在同一卷时,硬链接会退化为复制并打印完整堆栈的警告,可用 -Daether.installer.hardLink=false 关闭。Windows cmd.exe 默认没有彩色输出,需要加 --color=always。

回退与验证

官方未披露回退步骤。升级后先跑完整构建与测试,确认依赖解析顺序与插件行为,再逐步替换 CI 环境。

常见问题

Maven 3.10.1 和 Maven 4 有什么关系?
两者共用 Resolver 2.0 解析器,命令行语法与插件接口也尽量向 Maven 4 对齐。
Maven 3.10.1 对 POM 校验更严格了吗?
是的。重复的依赖与插件声明、非法版本字符等原先只告警的问题,现在会让构建失败。
Maven 3.10.1 为什么启动更快?
官方移除了 JLine 终端栈,彩色输出改用普通 ANSI 转义码,去掉了 3.10.0 引入的启动开销。
Maven 3.10.1 调用 Java 版本有要求吗?
要求 Java 8 或以上,与 Maven 3.9.x 系列保持一致。

相关术语

Apache Maven
Maven 是 JVM 生态的项目管理与构建工具,用 POM 描述依赖与构建流程。
Resolver
Resolver 是 Maven 负责解析与下载依赖的组件,决定版本仲裁与仓库访问方式。
POM
POM 是 Maven 的项目对象模型文件,用 XML 描述坐标、依赖、插件与构建配置。
classpath
classpath 是 JVM 查找类与资源时的路径集合,构建工具负责组装它。

这篇文章的来源是什么?

文中涉及版本、价格与功能的信息,均以厂商原文为准;下面是可以核对的原始出处。

「Maven 3.10.1」 —— Apache Maven

搜索文章

输入关键词,快速查找标题和正文内容。