Go Web契约性能测试体系：契约测试数据传输与优化 - 第3节

3.1 Pact 工作原理：从“约定”到“可执行契约”

Pact 的核心思想是“先约定，后实现”。在微服务架构中，服务之间的交互依赖接口定义（如 HTTP 路径、请求体、响应体）。Pact 将这种约定转化为机器可读、可验证的契约文件，确保消费者与提供者始终对齐。

3.1.1 消费者驱动契约

Pact 采用消费者驱动模式：由服务的调用方（Consumer）定义期望的交互，生成契约文件；提供者（Provider）随后验证自己能否满足这些期望。这种模式天然贴近业务需求，避免提供者过度设计。

3.1.2 核心交互流程

一次完整的 Pact 契约测试包含以下步骤：

1. 消费者编写测试：使用 pact-go 模拟提供者，定义请求与期望响应。
2. 生成契约文件：测试通过后，Pact 框架自动生成 consumer-provider.json 契约。
3. 上传至 Broker：将契约文件发布到 Pact Broker，供提供者拉取。
4. 提供者验证：提供者运行验证任务，将实际 API 响应与契约中的期望进行比对。
5. 结果回传：验证结果（通过/失败）回传至 Broker，形成闭环。

3.2 Pact Broker：契约的“版本控制中心”

Pact Broker 是 Pact 生态中的核心基础设施，它不仅仅是文件存储，更是一个契约版本管理与集成状态追踪平台。没有 Broker，契约文件只能通过 Git 仓库或共享磁盘传递，难以管理多版本、多环境。

3.2.1 Broker 的核心能力

3.2.2 部署方式

Pact Broker 支持多种部署方式，推荐使用 Docker 快速启动：

# 使用 Docker Compose 启动 Pact Broker + PostgreSQL
version: '3'
services:
  postgres:
    image: postgres:15
    environment:
      POSTGRES_USER: pact
      POSTGRES_PASSWORD: pact_pass
      POSTGRES_DB: pact_broker
  broker:
    image: pactfoundation/pact-broker:latest
    ports:
      - "9292:9292"
    environment:
      PACT_BROKER_DATABASE_URL: postgres://pact:pact_pass@postgres/pact_broker
      PACT_BROKER_PORT: 9292

3.3 Go 语言 Pact 库：pact-go 安装与配置

pact-go 是 Pact 协议的 Go 语言实现，它封装了与 Pact Broker 的交互、契约文件的生成与验证。pact-go 依赖一个独立的 Pact 命令行工具（pact-cli），安装时需一并处理。

3.3.1 安装步骤

1. 安装 pact-cli（推荐使用官方安装脚本）：

   # macOS / Linux
   curl -fsSL https://raw.githubusercontent.com/pact-foundation/pact-ruby-standalone/master/install.sh | bash
   # 验证安装
   pact --version

2. 安装 pact-go：

   go get github.com/pact-foundation/pact-go/v2
   go mod tidy

3. 配置环境变量（可选，用于指定 pact-cli 路径）：

   export PACT_CLI_PATH=/usr/local/bin/pact

3.3.2 项目初始化示例

以下是一个最小化的消费者测试骨架，展示 pact-go 的基本配置：

package consumer_test

import (
    "testing"
    "github.com/pact-foundation/pact-go/v2/consumer"
    "github.com/pact-foundation/pact-go/v2/matchers"
)

func TestUserServicePact(t *testing.T) {
    // 创建 Pact 实例
    pact := consumer.NewPact().
        WithPactFileWriteMode("merge").
        WithConsumer("UserServiceClient").
        WithProvider("UserServiceAPI").
        WithPactDir("./pacts")

    // 定义交互
    pact.AddInteraction().
        Given("user with ID 1 exists").
        UponReceiving("a request to get user").
        WithRequest("GET", "/users/1").
        WithHeader("Accept", "application/json").
        WillRespondWith(200).
        WithHeader("Content-Type", "application/json").
        WithBody(matchers.Like(map[string]interface{}{
            "id":   matchers.Like(1),
            "name": matchers.Like("Alice"),
        }))

    // 运行测试
    test := func() error {
        // 实际调用提供者 API 的代码
        return nil
    }

    if err := pact.Verify(test); err != nil {
        t.Fatalf("Pact verification failed: %v", err)
    }
}

3.3.3 配置项速查表

3.4 本章小结

• Pact 工作原理：消费者驱动契约，通过契约文件实现消费者与提供者的解耦验证。
• Pact Broker：作为契约的版本控制与状态管理中心，支持多环境、多版本的集成管理。
• pact-go 安装与配置：依赖 pact-cli，通过链式 API 快速定义交互，支持匹配器提升契约灵活性。