契约测试Mock测试与依赖隔离项目部署与参数配置与工程调优 - 第4节

4.1 Spring Cloud Contract 概述

Spring Cloud Contract 是 Spring 生态体系内官方提供的消费者驱动契约测试框架，旨在解决微服务间 HTTP 或消息通信的接口一致性问题。它允许团队以契约文件（Groovy DSL 或 YAML）定义服务提供者与消费者之间的交互约定，并自动生成提供者端验证测试与消费者端桩代码（Stub），从而在持续集成流水线中实现接口的早期验证与隔离。

4.2 核心概念

4.2.1 契约（Contract）

契约是 Spring Cloud Contract 的一等公民，使用 Groovy DSL 或 YAML 编写，描述一次完整的请求-响应交互。一个契约包含以下关键部分：

• 请求定义：HTTP 方法、路径、Headers、Query 参数、请求体（JSON/XML）。
• 响应定义：HTTP 状态码、Headers、响应体（含匹配规则）。
• 匹配策略：精确匹配、正则匹配、类型匹配、忽略额外字段等。
• 元数据：契约名称、描述、优先级、标签（用于分组）。

Contract.make {
    description "获取用户信息"
    request {
        method GET()
        url "/api/users/1"
        headers {
            accept(applicationJson())
        }
    }
    response {
        status OK()
        headers {
            contentType(applicationJson())
        }
        body([
            id: 1,
            name: "张三",
            email: "zhangsan@example.com"
        ])
    }
}

4.2.2 提供者端验证（Provider Verification）

提供者（服务端）引入 spring-cloud-starter-contract-verifier 依赖后，Spring Cloud Contract 会自动生成 JUnit 测试基类。开发者只需继承该基类并启动被测服务，框架便会读取契约文件，向实际服务发送请求并断言响应是否符合契约。若验证失败，构建立即中断。

4.2.3 消费者端桩代码（Consumer Stub）

消费者（客户端）引入 spring-cloud-starter-contract-stub-runner 依赖后，可通过 @AutoConfigureStubRunner 注解在测试中自动启动 WireMock 桩服务。桩服务根据契约文件返回预设响应，使消费者测试完全脱离真实提供者，实现隔离验证。

4.2.4 契约仓库（Contract Repository）

契约文件通常存放在提供者项目的 src/test/resources/contracts 目录下，或发布到共享 Maven / Artifactory 仓库。消费者通过 Stub Runner 从仓库下载桩 JAR，实现跨团队、跨项目的契约复用。

4.3 Spring Cloud Contract 与 Pact 的异同

Pact 是另一款广泛使用的消费者驱动契约测试框架，两者在理念上相似，但在实现细节、生态集成、使用方式上存在显著差异。下表从多个维度进行对比：

4.4 核心工作流程对比

下图展示了 Spring Cloud Contract 与 Pact 在消费者驱动契约测试中的核心工作流差异：

4.5 适用场景总结