1. 课程导论：为什么需要压测闭环？基准测试与契约测试在 Go 项目中的定位与价值

在 Go 项目从单体演进到微服务、从单机部署走向分布式集群的过程中，性能退化与接口不兼容是两类最隐蔽、破坏力最大的技术债务。传统“开发-测试-上线”流程往往在压测环节出现断层：基准测试只关注单点性能，契约测试只关注接口一致性，两者各自为战，无法形成闭环反馈。

本课程的核心主张是：将基准测试与契约测试纳入同一压测闭环，让性能指标与接口契约在每次代码变更后自动校验，从而在开发阶段就阻断性能回退与契约破坏。

1.1 压测闭环的定义与核心要素

压测闭环（Performance & Contract Closed Loop）是指：在 Go 项目的持续集成（CI）流水线中，对每次提交自动执行基准测试与契约测试，并将结果与基线对比，若性能退化超过阈值或契约被破坏，则阻断合并。其核心要素如下表所示：

1.2 基准测试在 Go 项目中的定位

Go 标准库 testing 包原生支持基准测试，这是 Go 语言相比其他静态语言的一大优势。基准测试在项目中的定位包括：

• 性能回归预防： 每次重构、升级依赖、修改算法后，通过基准测试快速发现性能退化。
• 优化效果量化： 任何性能优化必须以基准测试数据为依据，避免“感觉优化”陷阱。
• 资源消耗预算： 为关键路径设定 CPU 时间、内存分配次数的预算，超出即告警。

一个典型的 Go 基准测试代码结构如下：

// 文件: internal/cache/lru_test.go
func BenchmarkLRUGet(b *testing.B) {
    cache := NewLRUCache(1000)
    for i := 0; i < 1000; i++ {
        cache.Set(fmt.Sprintf("key-%d", i), i)
    }
    b.ResetTimer()
    for i := 0; i < b.N; i++ {
        cache.Get("key-500")
    }
}

1.3 契约测试在 Go 项目中的定位

契约测试（Contract Testing）位于单元测试与端到端测试之间，专注于验证服务间交互的协议一致性。在 Go 微服务架构中，契约测试的定位如下：

• 消费者驱动： 由消费者（Consumer）定义期望的请求/响应格式，提供者（Provider）验证是否满足。
• 快速反馈： 无需启动完整环境，通过模拟 HTTP/gRPC 交互即可验证，速度比集成测试快 10-100 倍。
• 接口文档即测试： 契约文件同时作为可执行的接口文档，避免文档与实现脱节。

使用 pact-go 的契约测试示例：

// 文件: consumer_test.go
func TestUserServiceContract(t *testing.T) {
    pact := &dsl.Pact{
        Consumer: "UserWebApp",
        Provider: "UserService",
    }
    pact.AddInteraction().
        Given("用户存在").
        UponReceiving("获取用户信息").
        WithRequest(dsl.Request{
            Method: "GET",
            Path:   dsl.String("/users/1"),
        }).
        WillRespondWith(dsl.Response{
            Status: 200,
            Headers: dsl.MapMatcher{"Content-Type": dsl.String("application/json")},
            Body:    dsl.Like(map[string]interface{}{"id": 1, "name": "Alice"}),
        })
    // 执行契约验证...
}

1.4 基准测试与契约测试的协同价值

两者单独使用都有盲区：基准测试无法验证接口语义正确性；契约测试无法感知性能退化。将它们纳入同一闭环后，产生以下协同效应：

1.5 压测闭环的整体架构

下图展示了压测闭环在 Go 项目 CI 流水线中的位置与数据流：

1.6 本课程的学习路径

本课程共 30 章，分为四个阶段，帮助您从零构建完整的压测闭环：

1. 基础篇（第 1-8 章）： 深入 Go 基准测试 API、benchstat 统计分析、pprof 性能剖析。
2. 契约篇（第 9-16 章）： 基于 pact-go 实现消费者驱动契约测试，覆盖 HTTP 与 gRPC 协议。
3. 闭环篇（第 17-24 章）： 在 CI 中集成基准测试与契约测试，实现基线对比与自动阻断。
4. 实战篇（第 25-30 章）： 在真实 Go 微服务项目中落地压测闭环，处理多服务、多契约、性能预算等进阶场景。