跳到主要内容
约 6 分钟3 张卡

Maven

Maven 用生命周期安排构建顺序,用插件执行具体工作,再根据依赖图确定项目需要哪些库。本文以 Maven 3 为范围,重点是阶段怎样执行、依赖版本怎样选择,以及多模块构建怎样保持一致。

理解这些关系后,才能解释为什么执行 verify 会先打包,为什么声明了版本却没有引入依赖,以及编译成功后为什么仍可能出现运行期依赖冲突。

1. 面试核心​

先记住这几条,再读正文
  • phase 定义构建阶段,绑定的插件 goal 执行具体工作;执行阶段时,先执行同一生命周期的前置阶段。
  • 未受显式管理的版本冲突采用最近路径优先,同深度先声明者优先的规则。卡 · 生命周期
  • dependencyManagement 提供版本等管理规则,不会单独引入依赖;依赖仍要来自直接声明或传递路径。
  • mvn -pl app -am verify 选择 app,并构建它依赖的 reactor 模块。卡 · 聚合、继承与 reactor
  • 配置 Failsafe 的相应 goal 后,执行 mvn verify 才能走完集成测试、后续清理和结果检查。卡 · 集成测试阶段

2. 生命周期​

生命周期是一组有顺序的构建阶段,Maven 的 clean、default 和 site 是三个独立生命周期。default 中的常用阶段如下:

validate → compile → test → package → verify → install → deploy

执行某个阶段(phase),会先执行同一生命周期中排在它前面的阶段。例如 mvn clean verify 先运行清理生命周期,再从 default 的起点执行到 verify,其中会经过编译、测试和打包。

install 将产物安装到本地仓库,deploy 将产物发布到远程仓库,供其他项目使用。这里的 deploy 是发布构建产物,应用上线仍由 CD 流程完成。

3. 插件 goal​

goal 是插件提供的具体动作,阶段只决定这些动作何时执行。例如测试是一个阶段,真正运行单元测试的工作可以由 Surefire 插件完成。项目的 packaging 和配置共同决定哪些 goal 绑定到哪些阶段。

Surefire 用于单元测试,Failsafe 用于集成测试。集成测试需要显式配置相应 goal,执行阶段并不会自动补齐缺少的插件绑定。

为了让构建行为稳定,插件版本与 JDK 版本都要固定。如果同一工作执行了多次,要检查父 POM 和子模块合并后的有效配置,确认是否重复绑定。

4. Scope​

scope 指定依赖在哪些类路径中可用,以及是否会传递给下游项目:

scope类路径与传递
compile默认范围,进入主编译、测试与运行,可传递
provided主编译与测试可用,运行环境提供,不传递
runtime测试与运行可用,主编译不可用
test仅测试使用,不向下游传递

经过传递路径引入的依赖,其最终 scope 还取决于路径上各段的 scope。system 直接指向本地文件,会降低跨环境可移植性;import 用于在 dependencyManagement 中导入 POM 的管理项。

5. 依赖仲裁​

依赖仲裁是在依赖图中出现同一库的多个版本时,决定实际使用哪一个版本。没有显式管理规则时,Maven 选择离当前项目最近的路径;路径深度相同时,先声明的路径优先。显式依赖版本和 dependencyManagement 可以控制这个选择。

定位冲突时,先看版本从哪里引入,以及继承后的配置是什么:

mvn dependency:tree
mvn help:effective-pom

dependency:tree 展示依赖的引入路径,help:effective-pom 展示合并继承等配置后得到的有效 POM。有了这些信息,再决定升级上游依赖、用 exclusion 精确排除,还是显式管理版本。

版本统一不等于调用一定兼容。依赖方可能使用了所选版本中不存在的方法,因此调整后仍需要验证二进制兼容性。

6. dependencyManagement 与 BOM​

dependencyManagement 提供依赖版本和默认配置,但单独列在其中的依赖不会进入类路径。只有直接声明或传递路径实际引入该依赖时,管理规则才参与解析。

BOM 是集中提供一组依赖管理规则的 POM,通过 type=pom、scope=import 导入。导入 BOM 带来的是这些版本规则,不会把其中所有库都加入项目。

pluginManagement 对插件提供类似的版本与配置管理。插件由生命周期或显式声明使用后,相关配置才会生效。另外,项目的 dependencyManagement 不管理插件自身使用的依赖。

7. 依赖收敛检查​

依赖收敛关注的是不同依赖路径是否指向同一版本。Enforcer 的 dependencyConvergence 检查这些路径的一致性,不能只看仲裁后最终剩下了几个 jar。

发现版本分叉后,可以用 dependencyManagement 统一版本,或精确排除不需要的路径。确实需要例外时,记录坐标、原因和期限。重复类则属于另一类问题,需要额外规则检查。

8. 可重复构建​

可重复构建要求相同输入重建后得到相同产物,所以输入不只包括源码,还包括 JDK、Maven、依赖、插件和仓库内容。Maven Wrapper 固定 Maven 分发版本,Toolchains 声明构建所需的工具链。

归档时间戳也会改变产物字节,可以通过 project.build.outputTimestamp 稳定它。字符集、时区和代码生成工具同样需要固定。

配置完成后,要独立重建并比较产物摘要,才能验证字节级重复性。构建后的同一产物怎样进入不同环境,见可重复交付。

9. 聚合、继承与 reactor​

聚合通过 modules 指定一起构建哪些模块,继承通过 parent 复用配置。两者可以由同一个 POM 承担,也可以分开,不能因为它们都出现在多模块项目中就混为一谈。

reactor 是 Maven 在一次构建中收集、排序和执行这些模块的机制。它根据实际依赖关系安排顺序,仅列在 dependencyManagement 中的管理项不影响排序。

只构建 app 及其依赖模块,可以在包含它们的聚合工程中执行:

mvn -pl app -am verify

-pl app 选择 app,-am 同时构建它依赖的 reactor 模块。-amd 的方向相反,选择依赖当前所选模块的下游模块。

10. 集成测试阶段​

配置 Failsafe 的 integration-test 和 verify goal 后,应执行 mvn verify,让集成测试、清理与结果检查都能完成。

Failsafe 在 integration-test 阶段记录测试失败,暂不因此终止构建。这样,绑定到 post-integration-test 的清理工作仍有机会执行,最后由 verify 检查结果并决定构建是否失败。

如果只运行 mvn integration-test,Maven 到该阶段就结束了,后面的环境清理和最终结果检查都会被跳过。

11. 常见问题​

11.1 package 和 install 有什么区别?​

package 生成 jar 或 war,install 在此基础上把产物与 POM 写入本地仓库。多模块项目中,reactor 可以在同一次构建里使用其他模块的产物,因此不必为了模块之间互相引用,每次都先单独执行 install。

11.2 编译通过,为什么运行时出现 NoSuchMethodError?​

12. 面试题卡片​

13. 参考资料​

来源:Coding 101 原文 · 免费阅读,引用请保留出处。内容使用说明