第 5 章 流水线作战：CI、性能与构建故障

第 5 章 流水线作战：CI、性能与构建故障

本章要回答的三个问题：

1. Maven 怎么接进持续集成流水线？缓存、分层、质量门禁在哪些位置挂载？
2. 构建从三分钟涨到二十分钟，病理是什么？加速手段的优先级怎么排？
3. 内存溢出与插件罢工这两类流水线高发故障，处置套路是什么？

为什么会有这一章

前四章的成果都活在"一台机器、一个开发者"的世界里。第 5 章把作战室搬进持续集成流水线：每一次提交触发构建，每一次构建跑全套验证，质量雷达全天扫描。规模化的同时也引入三类新敌人——流水线本身的配置复杂度、随代码膨胀的构建耗时、只在 CI 环境暴露的资源与兼容问题。

本章的叙事线是一场真实的优化战役：risk-engine 的流水线从 18 分钟优化到 4 分钟，途中依次处置了慢构建（5.2）、内存溢出（5.3）、插件兼容（5.4）三类故障，最后以可复现构建（5.5）与 SonarQube 质量雷达（5.6）收束建制。

读完能解决什么

• 设计一条 Maven 流水线：阶段划分、依赖缓存策略、构建命令组合与产物流转；
• 用测量驱动的顺序优化慢构建：先定位再动手，并行、增量、依赖预热的适用边界清楚；
• 独立处置 surefire 内存溢出与 fork 策略问题，配对插件版本兼容故障的诊断；
• 建立"同一个 commit 任何时间构建结果一致"的可复现构建纪律；
• 把 SonarQube 接进流水线作为质量门禁，理解它与其他环节的联动。

本章知识点清单

• 掌握流水线的缓存挂载点：本地仓库缓存的键设计（POM 指纹）与失效策略；
• 掌握 CI 常用命令组合：分层构建、选择性模块构建与产物流转的权限分离；
• 掌握构建耗时的测量方法与热点分布（依赖解析、编译、测试、打包各占多少）；
• 掌握并行构建 -T 的语义与线程安全前提，了解守护进程方案；
• 掌握 surefire 的 forkCount、argLine 配置与三类内存溢出的归属判定；
• 掌握插件版本锁定的意义与 enforcer 的 requirePluginVersions 规则；
• 掌握可复现构建三要素：版本全锁定、禁 SNAPSHOT、环境一致性；
• 掌握 SonarQube 扫描的接入位置、质量门禁配置与覆盖率联动。

图：流水线作战面板

各节怎么分工

先决条件

• 已读第 4 章，理解私服与 settings 通道（流水线的机器身份全靠它）；
• 手边有一个可用的 CI 平台（Jenkins、GitLab CI 或同类）更佳，没有也可读懂配置思想；
• 5.3 节涉及 JVM 内存区域概念（堆、元空间），有基础更顺。

本章战例的耗时线

整章沿着一条真实的耗时曲线推进：优化前 18 分钟（反馈半径严重超标）→ 测试分层与快照瘦身后 8 分钟 → 并行与选择性构建后 4.2 分钟（回到红线内）。曲线的每个拐点对应一节的处方，5.2 节的优先级表是全章的作战地图。读的时候可以带着自己团队的当前耗时对号入座——你们正卡在哪个拐点，就先读哪一节。

耗时之外还有两条暗线同步推进：稳定性线（内存溢出与插件兼容两类故障的处置，5.3 与 5.4 节）与制度线（可复现三要素与质量门禁，5.5 与 5.6 节）。速度、稳定、制度三线并进是流水线作战与个人本地构建的本质区别——本地构建只需要对自己负责，流水线是全队共享的生产资料，标准自然不同。

往下走到哪

流水线稳态运行后，工程化改造进入交付形态的最后一程。第 6 章面向跨栈协同与未来战场：Spring 深度协同、容器镜像、Kotlin 混编、GraalVM 原生编译，以及模块化与云原生的演进方向。