4. Mock隔离原理：Mock对象的作用、隔离测试的边界、Mock与Stub/Fake的区别

在契约验证体系中，Mock隔离是保障测试独立性与反馈速度的核心机制。理解Mock对象的作用边界、隔离原则以及它与Stub、Fake的差异，是正确设计测试套件的前提。本章从原理层剖析这三者，帮助你在Go语言项目中做出精准的测试替身选择。

4.1 Mock对象的核心作用

Mock对象是一种测试替身（Test Double），它的核心职责不是“模拟行为”，而是验证交互。具体来说，Mock对象在测试中扮演以下角色：

• 行为验证（Behavior Verification）：检查被测对象是否按预期调用了依赖对象的方法、传入了正确的参数、以及调用的次数和顺序。
• 状态隔离（State Isolation）：将被测单元与外部依赖（数据库、HTTP服务、消息队列）完全切断，确保测试失败只源于被测代码自身的逻辑错误。
• 契约守门人（Contract Gatekeeper）：在消费者驱动的契约测试中，Mock对象模拟提供者的响应，验证消费者是否遵守了约定的请求格式与交互流程。

4.2 隔离测试的边界

隔离测试的边界设计决定了测试的粒度与可信度。在Go语言中，边界划分遵循以下原则：

隔离边界的设计应遵循“最小依赖原则”：只Mock被测单元直接依赖的接口，不Mock间接依赖或内部实现细节。过度Mock会导致测试与实现耦合，降低重构弹性。

4.3 Mock与Stub/Fake的区别

很多开发者将Mock、Stub、Fake混为一谈，但它们在测试策略中扮演截然不同的角色。下表从多个维度进行对比：

4.4 三者在Go测试中的代码对比

以下代码展示了同一接口的三种替身实现方式，帮助你直观理解差异：

// 定义被依赖的接口
type UserRepository interface {
    FindByID(id int) (*User, error)
    Save(user *User) error
}

// ---- Stub实现：返回固定值 ----
type StubUserRepo struct{}

func (s *StubUserRepo) FindByID(id int) (*User, error) {
    return &User{ID: 1, Name: "Alice"}, nil
}
func (s *StubUserRepo) Save(user *User) error {
    return nil // 什么都不做
}

// ---- Fake实现：使用内存map模拟真实行为 ----
type FakeUserRepo struct {
    users map[int]*User
}

func (f *FakeUserRepo) FindByID(id int) (*User, error) {
    if u, ok := f.users[id]; ok {
        return u, nil
    }
    return nil, ErrNotFound
}
func (f *FakeUserRepo) Save(user *User) error {
    f.users[user.ID] = user
    return nil
}

// ---- Mock实现：使用gomock验证交互 ----
// 由 mockgen 自动生成，测试中用法如下：
func TestUserService_CreateUser(t *testing.T) {
    ctrl := gomock.NewController(t)
    defer ctrl.Finish()

    mockRepo := NewMockUserRepository(ctrl)
    // 设置期望：Save必须被调用一次，且参数符合预期
    mockRepo.EXPECT().
        Save(gomock.Any()).
        Return(nil).
        Times(1)

    svc := NewUserService(mockRepo)
    err := svc.CreateUser("Bob")
    assert.NoError(t, err)
    // Mock自动验证Save是否被调用了一次
}

4.5 选择替身的决策原则

在实际项目中，选择哪种替身取决于测试目标：

• 需要验证交互（调用次数、参数） → 使用 Mock（契约测试首选）
• 需要依赖返回特定值来驱动被测逻辑 → 使用 Stub（单元测试常用）
• 需要依赖具备真实行为但不想启动外部服务 → 使用 Fake（集成测试常用）
• 需要同时验证交互和返回值 → 使用 Mock + Stub 组合（gomock支持同时设置EXPECT和Return）

4.6 契约验证中的Mock隔离实践

在Go语言的契约验证框架（如pact-go）中，Mock隔离遵循以下原则：

1. 消费者端Mock提供者：在消费者测试中，Mock对象模拟提供者的HTTP响应或gRPC返回值，验证消费者是否按契约发送请求。
2. 交互记录生成契约文件：Mock对象记录每次交互的请求-响应对，生成契约文件（pact文件），作为消费者与提供者之间的约定。
3. 提供者端验证契约：提供者测试中，使用契约文件驱动真实服务，验证提供者是否满足所有约定的交互。
4. 隔离边界在接口层：Mock对象只模拟网络边界（HTTP/gRPC接口），不模拟业务逻辑，确保契约验证聚焦于API协议而非实现细节。

通过正确理解Mock隔离原理，你可以在Go项目中构建出既独立又可信的测试套件，让契约验证真正成为API治理的可靠基石。