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?
编译时使用的目标类有该方法,运行时加载的类却没有对应签名。需要检查最终包、容器提供的依赖和启动类路径,确认运行时实际加载了什么。IDE 中显示的依赖只能反映其中一个环境。
12. 面试题卡片
13. 参考资料
- Apache Maven:Introduction to the Build Lifecycle
- Apache Maven:Introduction to the Dependency Mechanism
- Maven Enforcer:Dependency Convergence
- Apache Maven:Reproducible Builds
- Apache Maven 3:Multiple Modules
- Maven Failsafe Plugin
来源:Coding 101 原文 · 免费阅读,引用请保留出处。内容使用说明