4. 契约测试概念：什么是契约测试、消费者驱动契约、提供者验证、与单元测试/集成测试的区别

契约测试（Contract Testing）是微服务架构中确保服务间通信一致性的轻量级测试方法。它不启动真实服务，而是通过“契约”文件定义消费者（Consumer）对提供者（Provider） API 的期望，再由提供者端验证这些期望是否被满足。这种测试介于单元测试与端到端集成测试之间，兼顾速度与可靠性。

4.1 核心概念

4.2 消费者驱动契约（CDC）工作流

1. 消费者定义期望：消费者团队编写契约，描述对提供者 API 的调用场景（如“查询用户信息返回 200 + JSON 结构”）。
2. 契约发布：契约文件上传至契约仓库（如 Pact Broker、本地文件系统）。
3. 提供者拉取契约：提供者 CI/CD 管道拉取最新契约。
4. 提供者验证：提供者启动真实 API 实例（或 Mock 层），模拟消费者请求，比对响应是否匹配契约。
5. 验证结果反馈：通过则发布提供者版本；失败则阻断发布，通知消费者团队。

4.3 提供者验证（Provider Verification）

提供者验证是契约测试的核心执行环节。提供者端通常通过以下步骤完成验证：

• 启动提供者 API：在测试环境中启动真实服务（或使用 Docker 容器）。
• 加载契约：从契约仓库获取消费者发布的契约文件。
• 重放请求：按契约中的请求参数向提供者发送 HTTP 调用。
• 断言响应：比对实际响应状态码、头信息、响应体结构与契约期望是否一致。
• 生成报告：输出验证通过/失败详情，包含不匹配字段的具体差异。

// 提供者验证代码片段
func TestProviderVerification(t *testing.T) {
    pactVerifier := &models.Verifier{}
    pactVerifier.Provider = "UserService"
    pactVerifier.ProviderBaseURL = "http://localhost:8080"
    pactVerifier.PactFiles = []string{"./pacts/consumer-user_service.json"}
    pactVerifier.ProviderStatesSetupURL = "http://localhost:8080/setup"

    err := pactVerifier.Verify(t)
    if err != nil {
        t.Fatalf("提供者验证失败: %v", err)
    }
}

4.4 契约测试 vs 单元测试 vs 集成测试

4.5 为什么选择契约测试

• 快速反馈：秒级验证，比集成测试快 10-100 倍，适合 CI/CD 流水线。
• 精准定位：直接指出哪个消费者期望与提供者实际响应不匹配，减少排查成本。
• 独立部署：消费者和提供者可独立发布，只要契约不变，双方互不阻塞。
• 文档即测试：契约文件本身就是 API 使用文档，新成员可快速理解接口约定。