Go / 系统课时
设计 CI 测试门禁
设计 CI 测试门禁
CI 门禁的目标不是把所有测试都塞进一次流水线,而是让高置信、低成本的检查尽快反馈,把昂贵任务放到主干或定时阶段。最终要得到一套能阻止明确缺陷合入、又不会因慢任务和性能噪声拖垮开发节奏的分层策略。
学习目标
- 按反馈速度和稳定性拆分单元、集成、覆盖率、竞态、基准与模糊测试
- 为 Pull Request 建立可复现、失败即阻断的快速门禁
- 区分“合并阻断信号”和“趋势观察信号”,避免把噪声指标当成硬阈值
先把检查按反馈速度分层
门禁首先解决两个问题:多久能得到结果,以及失败是否足够可信。单元测试和覆盖率通常适合每次提交;竞态检查成本更高,但能发现普通测试看不到的数据竞争;依赖外部服务的集成测试应在可控环境运行;基准和主动 fuzz 往往耗时且波动较大,更适合主干或定时任务。

可以用下面的门禁表决定任务位置:
| 检查 | 建议时机 | 是否默认阻断合并 | 主要原因 |
|---|---|---|---|
| 单元测试 | 每次 PR | 是 | 反馈最快,失败通常可直接定位 |
| 覆盖率阈值 | 每次 PR | 是 | 防止关键测试被意外删除,但阈值应稳定 |
| 竞态检查 | PR 独立任务 | 是 | 能发现数据竞争,耗时通常高于普通测试 |
| 集成测试 | PR 或主干 | 视环境稳定性 | 外部依赖容易引入非代码噪声 |
| 基准测试 | 主干或定时 | 通常否 | 结果受机器负载影响,应看趋势和统计比较 |
| 主动模糊测试 | 主干或定时 | 通常否 | 适合持续探索;发现的失败输入应固化为回归语料 |
把 Pull Request 门禁做成可复现脚本
不要把质量规则只写在 CI 平台页面里。将核心门禁收敛到仓库脚本,开发者本地和任意 CI 都能执行同一套命令。下面的 ci/pr-gate.sh 依次运行普通测试、竞态检查和覆盖率门槛;示例把最低覆盖率设为 80%,实际项目应根据当前基线逐步调整。
#!/usr/bin/env bash
set -euo pipefail
go test ./...
go test -race ./...
go test -coverprofile=coverage.out ./...
coverage="$(go tool cover -func=coverage.out | awk '/^total:/ {gsub("%", "", $3); print $3}')"
awk -v c="$coverage" 'BEGIN {
if (c + 0 < 80) {
printf "coverage %.1f%% < 80%%\n", c
exit 1
}
}'
printf 'coverage %s%% >= 80%%\n' "$coverage"预期输出
ok <MODULE>/<PACKAGE> <TIME>s
ok <MODULE>/<PACKAGE> <TIME>s
ok <MODULE>/<PACKAGE> <TIME>s coverage: <COVERAGE>% of statements
coverage <COVERAGE>% >= 80%<MODULE>、<PACKAGE>、<TIME> 与 <COVERAGE> 会随仓库、机器和测试集合变化。任一 go test 返回非零状态,或覆盖率低于阈值,脚本都会立即失败,因此 CI 只需把这个脚本配置为 PR 的必过任务。
把慢任务放到主干与定时阶段
集成测试是否阻断 PR,取决于测试环境是否稳定。如果它依赖数据库、消息系统或第三方服务,先保证环境可重复创建和清理,再把它提升为硬门禁;否则更适合作为主干检查,并对环境故障和业务断言失败分别告警。
基准测试不要直接用某一次 ns/op 与固定数字比较。稳定做法是固定 runner 规格、保存历史结果,并对多次样本做统计比较;明显回退再触发人工确认。主动 fuzz 也应按目标分别运行并设置时间预算,发现崩溃或断言失败后,把生成的失败输入提交到对应 testdata/fuzz/<FuzzName>/,这样普通 go test 就会在以后持续回归该输入。
用失败信号决定是否阻断
真正适合阻断合并的信号,应同时满足“失败与代码变化高度相关”和“重复运行结果稳定”。单元测试失败、确定的数据竞争、稳定环境中的集成断言失败通常属于这一类;性能抖动、共享环境超时和短时间 fuzz 没有发现新问题,则不能被解释为功能正确性的证明。
因此,门禁设计的重点不是任务越多越好,而是把快而确定的检查前置,把慢而有价值的检查持续运行,并把后者发现的确定性缺陷沉淀回前者。这样测试体系会随着缺陷积累变得更强,而不会让每次提交都承担所有成本。