1. 课程导论

1.1 什么是契约压测

契约压测（Contract Load Testing）是一种将接口契约验证与性能压测融合的集成测试方法。它在传统压测的基础上，对每个请求的响应进行结构化校验——不仅关注吞吐量和响应时间，还严格验证返回数据的格式、类型、枚举值范围、必选字段是否存在等契约规则。

在 Go Web 项目中，契约通常由 protobuf 文件、OpenAPI/Swagger 规范或内部 API 文档 定义。契约压测确保系统在高负载下依然遵守这些约定，不会出现字段缺失、类型错误、状态码异常等“压力下的契约违约”。

1.2 为什么需要契约压测

传统压测只关注性能指标，忽略了接口的正确性。实际生产环境中，高并发场景经常暴露以下问题：

1.3 Go Web项目中的契约压测价值

Go 语言在微服务和云原生领域应用广泛，其强类型、高并发的特性使得契约压测在 Go Web 项目中具有独特价值：

• 类型安全验证：Go 的 struct 和 json.Unmarshal 在低负载下通常表现良好，但高并发下容易因内存复用、竞态条件导致字段错位。契约压测能捕获这类问题。
• protobuf 兼容性：gRPC 服务在压力下可能出现字段编号映射错误、oneof 选择器异常，契约压测通过结构化校验确保二进制协议的正确性。
• 中间件副作用：Go 的 HTTP 中间件（如限流、鉴权、日志）在高并发下可能修改响应体结构，契约压测能发现中间件对契约的破坏。
• 回归防护：在 Go 项目重构或升级依赖库后，契约压测作为 CI 门禁，防止性能优化引入的契约违约。

1.4 课程目标

完成本课程后，你将具备以下能力：

• 掌握契约压测方法论：理解契约定义、校验规则、压测场景编排的核心原理。
• 搭建 Go 契约压测框架：基于 go test + httptest + 第三方断言库，构建可复用的压测基础设施。
• 编写结构化断言：使用 JSON Schema、protobuf 反射、自定义 validator 对响应进行深度校验。
• 集成 CI/CD 流水线：将契约压测作为自动化门禁，在代码合并前发现契约违约。
• 分析压测报告：从性能指标和契约通过率两个维度评估系统健康度。

1.5 学习路径

课程分为四个阶段，循序渐进：