3. 质量门禁概述
3.1 质量门禁的定义
质量门禁（Quality Gate）是嵌入在 CI/CD 流水线中的自动化检查点，用于在软件交付的每个关键阶段对制品或代码进行预设质量标准的验证。只有通过当前门禁的工件才能进入下一阶段，否则流水线将被阻断或标记为失败。
核心特征： 自动化执行、预设阈值、阻断机制、可追溯性。
与传统的“事后测试”不同，质量门禁将质量检查左移到开发与集成阶段，形成“先验证、后流转”的防护网。每个门禁对应一组可量化的质量指标，例如：
| 门禁类型 | 典型指标 | 阻断条件 |
|---|---|---|
| 代码质量门禁 | 圈复杂度、代码重复率、静态缺陷数 | 新增代码覆盖率 < 80% 或 blocker 级别缺陷 > 0 |
| 安全门禁 | 高危漏洞数、密钥泄露检测、依赖库 CVE | 存在 CVSS 7.0 以上漏洞 |
| 性能门禁 | P95 响应时间、吞吐量、内存泄漏率 | 响应时间退化超过 10% |
| 集成测试门禁 | 接口成功率、数据一致性、契约测试通过率 | 核心接口成功率 < 99.5% |
3.2 质量门禁在 CI/CD 流水线中的位置
质量门禁并非孤立存在，而是嵌入在流水线的各个阶段之间，形成“检查-反馈-阻断”的闭环。下图展示了典型 CI/CD 流水线中质量门禁的部署位置：
从图中可以看出，每个门禁都位于两个阶段之间，形成“阶段执行 → 门禁检查 → 通过则继续 / 失败则阻断”的循环。阻断路径（红色虚线）将失败信息反馈回开发阶段，确保问题在源头被修复。
最佳实践： 门禁应尽量左移。在代码提交阶段设置的门禁（如静态分析、单元测试）比部署阶段的门禁修复成本低 10 倍以上。建议至少在前三个门禁中覆盖 80% 的质量风险。
3.3 质量门禁的核心目标
质量门禁的设计围绕三个核心目标展开，这些目标直接服务于 MTTR 复盘与发布效率提升：
- 阻断缺陷扩散： 在缺陷进入下游环境之前将其捕获，避免“带病上线”导致的回滚和紧急修复。每提前一个阶段阻断缺陷，MTTR 可缩短 40%-60%。
- 提供可审计的质量证据： 每次门禁的通过/失败记录形成完整的质量追溯链，为 MTTR 复盘提供精确的“故障引入点”定位依据。
- 建立发布准入基线： 定义“什么是足够好的质量”，避免主观判断导致的发布决策偏差。门禁阈值应随业务风险动态调整。
下表总结了三个核心目标与 MTTR 复盘的具体关联：
| 核心目标 | MTTR 复盘价值 | 关键度量指标 |
|---|---|---|
| 阻断缺陷扩散 | 减少故障影响范围，缩短故障定位时间 | 门禁捕获率、逃逸缺陷数、平均阻断阶段 |
| 提供可审计的质量证据 | 快速定位故障引入点，减少排查时间 | 门禁日志完整性、追溯路径长度、证据可信度 |
| 建立发布准入基线 | 降低人为决策失误，减少发布回滚次数 | 门禁通过率、发布成功率、回滚率 |
常见误区： 门禁不是越多越好。过多的门禁会导致流水线延迟增加，反而降低发布频率。建议根据业务风险等级设置门禁数量，通常 3-5 个核心门禁即可覆盖 90% 的质量风险。每个门禁的检查时间应控制在 5 分钟以内。