契约驱动API测试工程 - 第4节
4. Pact框架入门
Pact 是目前业界最成熟的消费者驱动契约测试（Consumer-Driven Contract Testing, CDCT）框架。它由澳洲咨询公司 DiUS 于 2013 年开源，核心思想是：由 API 的消费者（Consumer）定义期望，由提供者（Provider）验证实现。Pact 将服务间的集成验证从“端到端冒烟”转变为“可独立运行的契约检查”，大幅降低微服务测试的耦合度和执行时间。
Pact 的核心定位：不是替代单元测试或集成测试，而是填补“服务间接口语义验证”的空白。它确保消费者和提供者对请求/响应的结构、字段、类型、状态码理解一致。
4.1.1 为什么需要 Pact？——传统集成测试的痛点
| 痛点 | 传统端到端测试 | Pact 契约测试 |
|---|---|---|
| 环境依赖 | 需要所有服务同时部署 | 消费者和提供者可独立运行 |
| 执行速度 | 分钟级甚至小时级 | 秒级（单元测试级别） |
| 失败定位 | 难以判断是哪个服务接口变更 | 契约文件精确指出变更点 |
| 测试维护 | 大量重复的冒烟脚本 | 消费者驱动，按需生成 |
| CI 集成 | 需要完整部署流水线 | 可嵌入单元测试阶段 |
4.2 Pact 核心概念：消费者驱动契约
Pact 的契约文件（通常为 JSON 格式）由消费者端生成，包含以下关键要素：
- 交互描述：对一次 API 调用的完整描述，包括请求方法、路径、请求头、请求体。
- 期望响应：消费者期望从提供者收到的状态码、响应头、响应体结构。
- 匹配规则：定义哪些字段必须精确匹配，哪些字段可以使用类型匹配、正则匹配或可选匹配。
- 提供者状态：描述提供者在处理请求前应处于的数据状态（如“用户已存在”或“用户不存在”）。
关键理解：契约文件不是 API 文档的替代品，而是可执行的、机器可读的接口约定。它比文档更精确，比代码更抽象。
4.2.1 消费者驱动契约的工作流程
下图展示了 Pact 契约测试的完整生命周期：消费者先定义期望，生成契约文件；提供者随后拉取契约并验证实现是否匹配。
流程要点：消费者先写测试，再生成契约；提供者后验证契约。这种“反向依赖”确保了提供者不会单方面破坏消费者期望的接口语义。
4.3 Pact 在 Go 中的生态：pact-go
Pact 官方为 Go 语言提供了 pact-go 库，它是 Pact 规范在 Go 生态中的完整实现。pact-go 支持 Go 1.18+，与标准 net/http 和主流框架（Gin、Echo、Chi）均可集成。
4.3.1 pact-go 核心组件
| 组件 | 作用 | 使用场景 |
|---|---|---|
pact.Consumer |
定义消费者名称和版本 | 消费者端测试初始化 |
pact.Provider |
定义提供者名称和版本 | 提供者端验证初始化 |
pact.Interaction |
描述一次请求/响应交互 | 消费者定义期望 |
pact.Matching |
提供匹配规则（类型、正则、可选） | 灵活验证响应字段 |
pact.Verify |
运行提供者验证 | 提供者端批量验证契约 |
pact.PactBroker |
与 Pact Broker 交互的客户端 | 发布/拉取契约文件 |
4.3.2 pact-go 安装与版本选择
# 安装 pact-go v2（推荐，支持 Pact 规范 v4）
go get github.com/pact-foundation/pact-go/v2
# 安装 Pact CLI（提供者验证需要）
# macOS
brew install pact-foundation/pact-ruby-standalone/pact
# Linux (x86_64)
curl -fsSL https://github.com/pact-foundation/pact-ruby-standalone/releases/download/v2.0.2/pact-2.0.2-linux-x86_64.tar.gz | tar xz
export PATH=$PATH:$(pwd)/pact/bin
# Windows (PowerShell)
# 下载 pact-2.0.2-win32.zip 并解压，将 bin 目录加入 PATH
版本兼容性注意：pact-go v2 要求 Go 1.18+，且需要本地安装 Pact CLI 用于提供者验证。如果使用 CI 环境，建议在 Docker 镜像中预装 Pact CLI 或使用官方 pact-cli Docker 镜像。
4.3.3 pact-go 在 Go 生态中的定位
下图展示了 pact-go 在 Go 微服务测试体系中的位置，以及与单元测试、集成测试、端到端测试的关系。
pact-go 的独特价值：它位于单元测试和集成测试之间，以秒级执行速度验证服务间接口契约，无需启动真实依赖服务。在 Go 微服务架构中，pact-go 是 CI 流水线中“快速反馈环”的关键一环。
4.3.4 pact-go 与主流 Go Web 框架的兼容性
| 框架 | 兼容性 | 集成方式 | 注意事项 |
|---|---|---|---|
| net/http | ✅ 原生支持 | 直接使用 http.Handler |
无需额外适配 |
| Gin | ✅ 完全兼容 | 通过 gin.Engine.Handler() |
注意中间件顺序 |
| Echo | ✅ 完全兼容 | 通过 echo.Echo.ServeHTTP |
需处理自定义上下文 |
| Chi | ✅ 完全兼容 | 直接使用 chi.Mux |
路由参数需显式注册 |
| Fiber | ⚠️ 部分兼容 | 需使用 fiber.App.Test() |
Fiber 的 fasthttp 底层需额外转换 |
4.4 本章小结
- Pact 是消费者驱动契约测试框架，核心思想是“消费者定义期望，提供者验证实现”。
- 消费者驱动契约 包含交互描述、期望响应、匹配规则和提供者状态四个核心要素。
- pact-go 是 Pact 规范的 Go 语言实现，支持 Go 1.18+，与 net/http、Gin、Echo、Chi 等主流框架兼容。
- pact-go 在测试金字塔中位于单元测试和集成测试之间，以秒级速度验证服务间接口契约。