构建与依赖 / 系统课时
构建优化与交付检查清单
构建优化与交付检查清单
Maven 优化应先减少不必要的模块和重复下载,再考虑并行线程;发布前则必须回到完整、可重复的 clean verify。本篇给出可直接使用的 reactor 选项、缓存边界和交付门禁,避免“本地更快”换来 CI 不稳定或漏测。
学习目标
- 正确使用
-T、-pl、-am和-rf缩短开发反馈时间。 - 区分本地仓库缓存、离线模式与构建输出缓存,避免误删或误用缓存。
- 用版本、测试、制品和发布前检查组成一套可重复的交付门禁。
并行构建先从一核一线程开始
对多模块项目可先试 -T 1C,表示每个 CPU 核心分配 1 个 Maven 构建线程。它只并行 reactor 中满足依赖关系的模块,不会让单个插件任务自动并行;如果插件或测试共享固定端口、临时目录或外部环境,并行后仍可能相互干扰。
mvn -T 1C -B -ntp clean verify预期输出:模块日志可能交错,但成功时会出现 reactor 汇总和 BUILD SUCCESS。线程数、模块顺序与耗时属于动态值。
[INFO] Using the MultiThreadedBuilder implementation with a thread count of <THREADS>
[INFO] Reactor Summary:
<PROJECT_MODULES>
[INFO] BUILD SUCCESS
[INFO] Total time: <TIME>若并行后出现只在 -T 模式发生的失败,先退回单线程复验,再检查共享资源和 Maven 提示的非线程安全插件。不要直接把线程数从 1C 提到 2C 或更高;先比较三次构建耗时与失败率,只有稳定缩短总时长才值得保留。
用 reactor 选择代替“全项目重跑”
日常开发最有效的“增量”通常不是依赖 Maven 猜哪些源码变了,而是明确选择需要重建的模块。-pl :app -am test 会构建 app 以及它依赖的 reactor 模块;构建中途失败后,可用 -rf :module 从指定模块恢复后续 reactor。
常用命令可按场景选:
| 场景 | 命令 | 边界 |
|---|---|---|
只改 app,还要构建它依赖的模块 |
mvn -pl :app -am test |
不会自动构建依赖 app 的下游模块 |
| 修改公共库,要验证所有下游 | mvn -pl :core -amd test |
-amd 构建依赖该模块的项目 |
| 多模块构建失败后继续 | mvn -rf :module verify |
适合修复后恢复,不等同于全新 clean 构建 |
| 只做快速打包且暂不运行测试 | mvn -DskipTests package |
测试源码通常仍会编译,不能作为发布门禁 |
缓存只缓存可复用的东西
Maven 本地仓库默认位于 ~/.m2/repository,主要缓存依赖、插件和元数据。CI 中保留这部分缓存通常能减少网络下载;缓存键至少应考虑操作系统、JDK 版本以及 POM 或依赖锁定信息的变化,避免把不同构建环境混成一个无边界缓存。
mvn -o test 使用离线模式,只允许使用本地已经存在的依赖和插件;缺失制品时会直接失败。mvn -nsu test 可避免检查 SNAPSHOT 更新,适合网络稳定性测试或短期开发循环,但不应掩盖真正需要刷新的 SNAPSHOT。需要主动检查新 SNAPSHOT 时使用 -U。
Maven 核心的本地仓库缓存不等于“复用上一次 target 目录的编译产物”。执行 clean 会删除模块输出;若团队要缓存构建输出,需要单独引入并版本化构建缓存扩展或 CI 缓存方案,并用干净环境验证命中和失效规则,不能把 target 整目录无条件跨分支复用。
交付前固定一条干净构建命令
发布前应使用与 CI 相同的 Maven 与 JDK。项目有 Maven Wrapper 时优先执行 ./mvnw -version;没有 Wrapper 时至少记录 mvn -version。版本确认后,再执行干净的批处理构建,-B 关闭交互,-ntp 关闭下载进度条,便于 CI 日志稳定解析。

下面这条命令适合作为本地与 CI 的共同基线;它不依赖增量状态,也不会因为之前的 target 目录而“误成功”。
mvn -B -ntp clean verify预期输出:所有模块完成测试和绑定在 verify 之前或之上的检查,最终为 BUILD SUCCESS。具体插件日志、模块数和耗时随项目变化。
[INFO] Reactor Summary:
<PROJECT_MODULES>
[INFO] BUILD SUCCESS
[INFO] Total time: <TIME>用四项清单验收版本、测试、制品与发布条件
先取项目版本:mvn -q help:evaluate -Dexpression=project.version -DforceStdout,预期只打印当前 project.version,例如 1.4.0。若准备正式发布却仍是 -SNAPSHOT,应先按团队版本策略修正,而不是在 deploy 阶段再处理。
交付前逐项检查以下内容:
- 版本:Maven、JDK、
project.version与 CI 记录一致;正式发布按团队规则确认是否允许SNAPSHOT。 - 测试与质量门:完整
clean verify成功,Surefire、Failsafe、Checkstyle、SpotBugs 或其他已绑定插件没有被命令行参数跳过。 - 制品:检查
target中主 JAR/WAR 的文件名、大小和清单;可用jar tf target/<ARTIFACT>.jar确认关键类或资源确实进入制品。 - 发布条件:仓库地址、
settings.xml中的server标识、凭据注入和签名要求已在 CI 环境验证;不要把明文密码写进 POM。
最后一次交付验证不要使用 -o、-nsu 或 -DskipTests 这类加速开关。开发阶段可以用局部模块、并行线程和本地仓库缩短反馈;真正要发布的制品应来自一条从干净工作区执行并且完整通过 verify 的构建链。