2. 核心概念：消费者驱动契约、提供者验证、契约文件格式

契约测试的核心在于“消费者驱动”这一思想。与传统的由提供者定义接口不同，消费者驱动契约（Consumer-Driven Contract, CDC）将接口的“话语权”交给了服务的调用方。本章将深入剖析这一模式的核心概念、验证流程以及主流的契约文件格式。

2.1 消费者驱动契约（CDC）

消费者驱动契约是一种测试策略，其中消费者（调用方）定义其对提供者（被调用方）的期望，并以契约文件的形式记录下来。提供者则负责验证自己是否满足这些契约。

关键角色与职责：

• 消费者（Consumer）： 编写契约，定义期望。通常由消费者团队的开发者在集成测试阶段完成。
• 提供者（Provider）： 验证契约，确保实现与契约一致。提供者团队在持续集成流水线中运行验证任务。
• 契约文件（Contract）： 消费者与提供者之间的“协议”，是双方集成的唯一标准。

2.2 提供者验证

提供者验证是契约测试的“守门员”。提供者团队在持续集成（CI）流水线中，针对每个新构建运行验证任务，确保当前版本的实现与所有消费者定义的契约保持一致。

验证流程：

1. 拉取契约： 从契约仓库（如 Git 仓库、Pact Broker）获取所有相关的消费者契约。
2. 启动提供者： 在测试环境中启动提供者服务（通常使用嵌入式服务器或 Docker 容器）。
3. 回放交互： 验证框架模拟消费者请求，发送给提供者，并比对实际响应与契约中的期望响应。
4. 生成报告： 输出验证结果，包括通过的交互、失败的交互及具体差异。

2.3 契约文件格式

目前主流的契约测试框架有 Pact 和 Spring Cloud Contract，它们各自定义了不同的契约文件格式。理解这些格式是编写和解析契约的基础。

2.3.1 Pact 契约示例（JSON）

Pact 契约以 JSON 格式存储，结构清晰，易于阅读和版本控制。以下是一个典型的 Pact 契约片段：

{
  "consumer": { "name": "OrderService" },
  "provider": { "name": "UserService" },
  "interactions": [
    {
      "description": "a request for user details",
      "providerState": "user with ID 123 exists",
      "request": {
        "method": "GET",
        "path": "/users/123",
        "headers": { "Accept": "application/json" }
      },
      "response": {
        "status": 200,
        "headers": { "Content-Type": "application/json" },
        "body": {
          "id": 123,
          "name": "John Doe",
          "email": "john@example.com"
        },
        "matchingRules": {
          "$.body.id": { "match": "type" },
          "$.body.email": { "match": "regex", "regex": "\\S+@\\S+\\.\\S+" }
        }
      }
    }
  ]
}

2.3.2 Spring Cloud Contract 契约示例（Groovy DSL）

Spring Cloud Contract 使用 Groovy DSL 或 YAML 定义契约，与 Spring Boot 项目无缝集成。以下是一个 Groovy DSL 契约示例：

Contract.make {
  description "should return user details"
  request {
    method GET()
    url "/users/123"
    headers {
      accept(applicationJson())
    }
  }
  response {
    status OK()
    headers {
      contentType(applicationJson())
    }
    body([
      id: 123,
      name: "John Doe",
      email: "john@example.com"
    ])
  }
}

2.4 核心概念总结

消费者驱动契约、提供者验证和契约文件格式共同构成了契约测试的三大支柱。理解它们之间的关系，是后续章节中实现集成环境回放与稳定性校验的基础。

• 消费者驱动契约 是“为什么”——它定义了测试的出发点和目标。
• 提供者验证 是“怎么做”——它提供了确保契约被遵守的机制。
• 契约文件格式 是“用什么”——它提供了标准化的沟通语言。