Go / 系统课时

基准测试关键处理器

基准测试关键处理器

本节为 HTTP 热路径建立可重复的基准测试。重点不是得到一个漂亮的延迟数字,而是用 testing.B 同时观察每次操作耗时、分配字节数和分配次数,再通过同一环境下的多次样本判断改动是否真的更快、更省内存。

学习目标

  • 用 testing.B 为关键处理器建立稳定的性能基线
  • 正确读取 ns/op、B/op 与 allocs/op
  • 用多次运行比较改动前后差异,避免被单次抖动误导

选择要测的热路径

处理器基准应尽量只覆盖准备优化的应用路径,不要把启动服务器、建立 TCP 连接等一次性成本混进循环。下面将代码保存为 handler_bench_test.go:请求对象和响应写入器在计时前创建,循环里只执行处理器,从而把测量重点放在响应头处理与 JSON 编码上。

go
package handlerbench

import (
    "encoding/json"
    "net/http"
    "testing"
)

type userResponse struct {
    ID          int    `json:"id"`
    DisplayName string `json:"name"`
}

func userHandler(w http.ResponseWriter, _ *http.Request) {
    const contentType = "application/json"
    w.Header()["Content-Type"] = []string{contentType}
    _ = json.NewEncoder(w).Encode(userResponse{
        ID:          42,
        DisplayName: "Ada",
    })
}

type discardResponseWriter struct {
    headers http.Header
}

func (w *discardResponseWriter) Header() http.Header {
    return w.headers
}

func (w *discardResponseWriter) Write(p []byte) (int, error) {
    return len(p), nil
}

func (w *discardResponseWriter) WriteHeader(statusCode int) {}

func BenchmarkUserHandler(b *testing.B) {
    req, err := http.NewRequest(http.MethodGet, "http://example.test/users/42", nil)
    if err != nil {
        b.Fatal(err)
    }
    rw := &discardResponseWriter{headers: make(http.Header)}

    // 固定测试夹具放在计时之外,只统计每次处理器调用的成本。
    b.ReportAllocs()
    b.ResetTimer()

    for i := 0; i < b.N; i++ {
        userHandler(rw, req)
    }
}

这里使用丢弃响应体的轻量 ResponseWriter,避免把测试记录器自身的缓冲成本计入目标路径。它不包含真实网络 I/O,因此回答的是“处理器函数本身有多贵”,而不是客户端端到端请求有多快。如果目标变成路由匹配或中间件链,就应把相应调用纳入 b.N 循环,同时继续把固定请求构造放在计时之外。

建立可重复基线

在包含该基准文件的 Go 模块中执行多次运行。-run '^$' 跳过普通测试,-benchmem 输出分配指标,-count=5 为同一个基准收集五组样本。

bash
go test -run '^$' -bench '^BenchmarkUserHandler$' -benchmem -count=5

预期输出:

text
goos: <OS>
goarch: <ARCH>
pkg: <PACKAGE>
cpu: <CPU>
BenchmarkUserHandler-<P>    <N>    <NS_PER_OP> ns/op    <B_PER_OP> B/op    <ALLOCS_PER_OP> allocs/op
BenchmarkUserHandler-<P>    <N>    <NS_PER_OP> ns/op    <B_PER_OP> B/op    <ALLOCS_PER_OP> allocs/op
BenchmarkUserHandler-<P>    <N>    <NS_PER_OP> ns/op    <B_PER_OP> B/op    <ALLOCS_PER_OP> allocs/op
BenchmarkUserHandler-<P>    <N>    <NS_PER_OP> ns/op    <B_PER_OP> B/op    <ALLOCS_PER_OP> allocs/op
BenchmarkUserHandler-<P>    <N>    <NS_PER_OP> ns/op    <B_PER_OP> B/op    <ALLOCS_PER_OP> allocs/op
PASS
ok      <PACKAGE>    <TIME>

<OS>、<ARCH>、<CPU>、<P>、<N>、<NS_PER_OP>、<B_PER_OP>、<ALLOCS_PER_OP> 和 <TIME> 都取决于运行环境。比较前后版本时,应保持同一台机器、同一 Go 版本、相同命令,并尽量维持接近的系统负载。

读懂时间与分配指标

指标 含义 常见判断
ns/op 每次基准操作的平均耗时 多组样本整体下降才更有说服力
B/op 每次操作平均分配的字节数 增长可能提高垃圾回收压力
allocs/op 每次操作平均发生的堆分配次数 热路径减少分配通常有利于高并发稳定性

不要把某一次 ns/op 的小幅下降直接判定为优化成功。CPU 频率变化、后台任务、调度和垃圾回收都会造成抖动,因此要观察多次样本的整体趋势。如果时间改善,但 B/op 或 allocs/op 明显恶化,还需要评估更高并发下增加的 GC 成本。

保持前后结果可比

建立基线后再修改实现,并用完全相同的命令重新运行。最重要的是保持被测操作一致:如果改动前只测处理器函数,改动后却把路由、日志或额外测试对象一起放进循环,两组数字就失去了直接可比性。

基准循环中也不要加入字符串格式化日志、断言或与业务无关的对象创建,否则测试辅助工作会污染结果。功能正确性应由普通 Test... 测试负责,Benchmark... 只稳定测量真正关心的热路径。只有多次样本在耗时和分配指标上都呈现可解释的改善,才应把改动视为有效的性能优化。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

基准测试关键处理器

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通