3. 契约测试基础：消费者驱动契约(CDC)、提供者契约、Pact框架介绍

在微服务架构中，服务间的API依赖关系错综复杂。契约测试（Contract Testing）是一种轻量级的集成测试策略，它不直接部署服务，而是通过验证服务间通信的“契约”来确保兼容性。本章将深入剖析契约测试的核心概念：消费者驱动契约（CDC）、提供者契约，以及业界最成熟的Pact框架。

3.1 消费者驱动契约（CDC）

消费者驱动契约（Consumer-Driven Contract, CDC）是一种以消费者（调用方）为驱动的契约定义模式。其核心理念是：由API的消费者定义其对提供者的期望，提供者则验证这些期望是否被满足。这种模式将契约的“所有权”交给消费者，确保提供者的变更不会破坏现有消费者的功能。

3.1.1 CDC工作流程

1. 消费者编写测试： 消费者团队使用契约测试框架（如Pact）编写测试，描述其对提供者API的请求与期望响应。
2. 生成契约文件： 测试运行后，自动生成一份JSON或YAML格式的契约文件（Pact文件），包含所有交互细节。
3. 共享契约： 契约文件通过共享存储（如Git仓库、Pact Broker）传递给提供者团队。
4. 提供者验证： 提供者团队运行验证测试，模拟消费者请求，检查实际响应是否匹配契约中的期望。
5. 发布结果： 验证通过后，提供者可以安全发布；若失败，则需修复API或与消费者协商更新契约。

3.1.2 CDC vs. 传统集成测试

3.2 提供者契约

提供者契约（Provider Contract）是CDC的对称概念。它由提供者（服务端）定义，描述其API能够提供的功能和约束。提供者契约通常包含：

• API端点与HTTP方法： 如 GET /api/orders/{id}。
• 请求参数与格式： 必填/可选参数、数据类型、格式约束。
• 响应结构与状态码： 成功响应（200）、错误响应（400/404/500）的JSON Schema。
• 业务规则： 如“订单状态为‘已支付’时不可取消”。

3.3 Pact框架介绍

Pact是目前最流行的契约测试框架，支持多种编程语言（Java、JavaScript、Python、Go、.NET等）。它实现了完整的CDC工作流，并提供契约文件管理、验证、发布等工具链。

3.3.1 Pact核心组件

3.3.2 消费者端测试示例（Java + Pact JVM）

// 消费者测试：定义对订单服务的期望
@ExtendWith(PactConsumerTestExt.class)
@PactTestFor(providerName = "order-service", port = "8080")
public class OrderServiceConsumerTest {

    @Pact(consumer = "payment-service")
    public V4Pact createOrderPact(PactDslWithProvider builder) {
        return builder
            .given("订单存在且状态为待支付")
            .uponReceiving("请求订单详情")
                .path("/api/orders/123")
                .method("GET")
            .willRespondWith()
                .status(200)
                .headers(Map.of("Content-Type", "application/json"))
                .body(new PactDslJsonBody()
                    .integerType("id", 123)
                    .stringType("status", "PENDING_PAYMENT")
                    .decimalType("amount", 99.99)
                )
            .toPact(V4Pact.class);
    }

    @Test
    void testGetOrder() {
        // 使用Mock服务验证消费者逻辑
        OrderClient client = new OrderClient("http://localhost:8080");
        Order order = client.getOrder(123);
        assertEquals("PENDING_PAYMENT", order.getStatus());
    }
}

3.3.3 提供者端验证示例（Java + Pact Provider Verifier）

// 提供者验证：检查实际API是否满足消费者契约
@Provider("order-service")
@PactBroker(url = "http://pact-broker:9292")
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
public class OrderServiceProviderTest {

    @LocalServerPort
    int port;

    @BeforeEach
    void setup() {
        System.setProperty("pact.verifier.publishResults", "true");
    }

    @TestTemplate
    @ExtendWith(PactVerificationInvocationContextProvider.class)
    void pactVerificationTestTemplate(PactVerificationContext context) {
        context.verifyInteraction();
    }

    @TestTarget
    public final Target target = new HttpTarget("http://localhost", port);
}

3.3.4 Pact工作流示意图

3.4 Pact框架关键特性

• 多语言支持： 同一Pact契约文件可在不同语言的服务间使用（如Java消费者 + Python提供者）。
• 匹配规则灵活： 支持精确匹配、正则匹配、类型匹配、可选字段等，避免过度耦合。
• 状态管理（Provider States）： 提供者可通过“给定状态”（如“订单存在”）准备测试数据，确保验证的准确性。
• 契约版本化： Pact Broker支持语义化版本，可追踪消费者与提供者的版本兼容性矩阵。
• Webhook与CI集成： 契约变更时自动触发提供者验证，实现“变更即验证”。

3.5 消费者契约 vs. 提供者契约对比