契约驱动API测试工程 - 第1节
1. 课程导论
契约测试驱动开发（Contract Test Driven Development，CTDD）是一种以服务间契约为核心、先定义接口约定、再实现服务逻辑的API开发方法论。它把传统TDD中“先写单元测试、再写实现代码”的思想，提升到微服务架构下的跨服务契约层面。
核心定义：CTDD 要求开发者在编写任何服务代码之前，先使用契约文件（如 OpenAPI、gRPC proto、AsyncAPI）精确描述 API 的请求/响应结构、状态码、错误格式、性能基线（P99 延迟、吞吐量），然后基于该契约同时生成消费者端模拟（Mock）和提供者端验证（Verifier），最后才进入业务逻辑实现。
CTDD 与传统 TDD 的对比
| 维度 | 传统 TDD | 契约测试驱动开发（CTDD） |
|---|---|---|
| 测试范围 | 单个函数/方法 | 跨服务 API 契约 |
| 驱动顺序 | 测试 → 实现 → 重构 | 契约定义 → 模拟/验证 → 实现 → 压测闭环 |
| 关注点 | 逻辑正确性 | 接口兼容性 + 性能基线 |
| 失败反馈 | 单元测试红/绿 | 契约校验失败 + 压测阈值告警 |
| 适用场景 | 单体应用、内部逻辑 | 微服务、API Gateway、第三方集成 |
CTDD 的关键区别：契约不仅是接口文档，更是可执行的断言。在 Go 生态中，我们可以用
oapi-codegen 从 OpenAPI 契约生成服务桩代码，用 pact-go 做消费者驱动契约测试，再用 vegeta 或 k6 对契约中的性能基线做压测验证。
1.2 为什么需要契约压测闭环？
在微服务架构中，仅靠单元测试和集成测试无法覆盖以下三个关键风险：
- 契约漂移：服务提供者修改了响应字段，消费者未同步更新，导致线上解析失败。
- 性能退化：某次重构虽然功能正确，但 P99 延迟从 50ms 飙升到 500ms，未被测试发现。
- 级联故障：上游服务因超时重试压垮下游，而契约中从未定义过流量阈值。
契约压测闭环将契约测试与性能压测整合为一个自动化反馈环：
没有压测的契约测试是“半闭环”：传统契约测试只验证接口格式是否正确，不验证接口在压力下是否仍能遵守契约。一个在低负载下正确的 API，在高并发下可能返回 503、超时或数据截断，这些都属于契约违反。
闭环流程概览
下图展示了契约压测闭环的核心阶段与数据流向：
1.3 课程目标
完成本课程后，你将具备以下能力：
- 契约设计能力：使用 OpenAPI 3.1 和 gRPC proto 编写精确、可执行的 API 契约，包含请求/响应结构、错误码、速率限制和性能基线。
- Go 代码生成：熟练使用
oapi-codegen、protoc-gen-go从契约生成服务端桩代码和客户端 SDK。 - 契约测试实现：基于
pact-go编写消费者驱动契约测试，在 CI 中自动验证服务兼容性。 - 性能压测集成：使用
vegeta和k6对契约中定义的性能基线（P99、RPS、错误率）进行自动化压测。 - 闭环流水线搭建：在 GitHub Actions 或 GitLab CI 中构建“契约验证 → 压测 → 基线比对 → 部署”的自动化流水线。
1.4 学习路径
课程共 30 章，分为五个阶段，建议按顺序学习：
| 阶段 | 章节范围 | 核心产出 |
|---|---|---|
| 基础篇 | 第 1-6 章 | 理解 CTDD 理念，掌握 OpenAPI 契约编写与 Go 代码生成 |
| 契约测试篇 | 第 7-14 章 | 实现消费者驱动契约测试，搭建 Mock 服务与验证器 |
| 性能压测篇 | 第 15-22 章 | 编写压测脚本，定义性能基线，集成 vegeta/k6 |
| 闭环集成篇 | 第 23-27 章 | 构建 CI/CD 流水线，实现契约验证 + 压测自动化 |
| 实战案例篇 | 第 28-30 章 | 完整电商订单服务 CTDD 闭环项目实战 |
学习建议：每章都包含可运行的 Go 代码示例。建议在本地准备好 Go 1.21+ 环境、Docker（用于 Pact Broker 和压测工具）、以及一个 GitHub 仓库用于练习 CI 流水线。第 2 章将带你快速搭建开发环境并创建第一个契约文件。
1.5 本章小结
契约测试驱动开发（CTDD）将契约作为微服务开发的第一性原理，而契约压测闭环则在此基础上增加了性能维度的契约验证。本课程将带你从零搭建一套完整的 Go Web 服务契约压测闭环体系，让每一次 API 变更都经过格式校验和性能基线的双重保障。