Go / 系统课时
基准测试关键处理器
基准测试关键处理器
本节为 HTTP 热路径建立可重复的基准测试。重点不是得到一个漂亮的延迟数字,而是用 testing.B 同时观察每次操作耗时、分配字节数和分配次数,再通过同一环境下的多次样本判断改动是否真的更快、更省内存。
学习目标
- 用
testing.B为关键处理器建立稳定的性能基线 - 正确读取
ns/op、B/op与allocs/op - 用多次运行比较改动前后差异,避免被单次抖动误导
选择要测的热路径
处理器基准应尽量只覆盖准备优化的应用路径,不要把启动服务器、建立 TCP 连接等一次性成本混进循环。下面将代码保存为 handler_bench_test.go:请求对象和响应写入器在计时前创建,循环里只执行处理器,从而把测量重点放在响应头处理与 JSON 编码上。
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 为同一个基准收集五组样本。
go test -run '^$' -bench '^BenchmarkUserHandler$' -benchmem -count=5预期输出:
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... 只稳定测量真正关心的热路径。只有多次样本在耗时和分配指标上都呈现可解释的改善,才应把改动视为有效的性能优化。