Golanghttptest实战教程详解

本文深入解析了 Go 语言中 `net/http/httptest` 包的两种核心测试模式：用 `httptest.NewRecorder` 轻量、高效地单元测试单个 HTTP handler（适合验证逻辑、状态码、JSON 序列化等），以及用 `httptest.NewServer` 真实模拟完整 HTTP 服务链路（专用于测试中间件、路由、客户端行为、重定向和依赖注入场景），并强调关键实践——90% 的单元测试无需启动端口，避免常见陷阱如 panic、端口泄漏、全局 client 干扰、中间件未生效和上下文超时卡死，真正教会你写出可维护、可复现、贴近生产逻辑的高质量 HTTP 测试。

直接用 httptest.NewRecorder 测 handler，用 httptest.NewServer 测 client 或中间件链路——别一上来就起服务，90% 的单元测试用不到端口。

测单个 handler 函数：用 httptest.NewRequest + httptest.NewRecorder

这是最轻量、最常用的方式，适合验证路由逻辑、JSON 序列化、状态码等。不占端口、不走网络、执行快，还能断言内部调用（比如是否查了 DB）。

• http.NewRequest 构造请求时，body 为 nil 表示空体；传 JSON 要用 strings.NewReader(`{...}`) 并显式设 Content-Type: application/json
• httptest.NewRecorder 返回的 *httptest.ResponseRecorder 不是 http.ResponseWriter 实现体，但兼容；可直接读 .Code、.Body.Bytes()、.Header()
• 常见错误：传 nil 给 handler.ServeHTTP 导致 panic；或忽略 JSON 字段类型（map[string]interface{} 中数字是 float64）

req, _ := http.NewRequest("POST", "/login", strings.NewReader(`{"user":"a","pass":"123"}`))
req.Header.Set("Content-Type", "application/json")
rr := httptest.NewRecorder()
handler := http.HandlerFunc(LoginHandler)
handler.ServeHTTP(rr, req)
if rr.Code != http.StatusOK {
    t.Errorf("expected status OK, got %d", rr.Code)
}

测完整服务链路（含中间件、路由、重定向）：必须用 httptest.NewServer

当你用 Gin、Echo 或自定义 http.ServeMux，且中间件（如 JWT 鉴权、CORS、日志）参与响应流程时，NewRecorder 会跳过它们——必须把整个 handler 树丢给 NewServer。

• NewServer 启一个真实本地 HTTP 服务，返回带协议和随机端口的 srv.URL（如 "http://127.0.0.1:34212"），客户端代码必须用它，不能硬写 "localhost:8080"
• 每次调用都绑定新端口，务必 defer srv.Close()，否则测试间端口耗尽、goroutine 泄漏
• 不支持 HTTPS，默认只跑 HTTP；若需 TLS 测试，得用 httptest.NewUnstartedServer 手动配 srv.TLS

srv := httptest.NewServer(http.NewServeMux())
defer srv.Close() // 关键
resp, err := http.Get(srv.URL + "/api/user")
if err != nil {
    t.Fatal(err)
}
defer resp.Body.Close()

测 HTTP 客户端行为（比如重试、header 透传、跳转）：也得用 httptest.NewServer

如果你在写一个封装了 http.Client 的 SDK 或工具函数，重点不是 handler 怎么处理，而是 client 怎么发、怎么收、怎么响应错误——这时 NewServer 是唯一可靠方式。

• 别用 http.DefaultClient，它带全局连接池和默认超时，干扰测试可复现性；自己 new 一个干净的 &http.Client{}
• handler 里用 w.WriteHeader() 和 w.Write() 精确控制响应，包括 302 跳转、401 拒绝、流式 body 等
• 容易被忽略：client 发出的请求可能带 ctx.WithTimeout，server handler 必须检查 req.Context().Done()，否则测试卡死

中间件测试最容易漏掉的点：包装顺序和依赖注入

中间件本质是 func(http.Handler) http.Handler，测试时必须把目标 handler 包进链里再丢给 recorder/server，否则中间件逻辑完全没跑。

• 典型错误：直接测 LoggingMiddleware(UserHandler) 却忘了传入一个实际的 http.Handler 做 next，导致 next.ServeHTTP panic
• 如果中间件依赖外部状态（如数据库连接、配置变量），测试前要重置或注入 mock，否则测试间污染
• 组合多个中间件时，执行顺序必须和线上一致；例如 Auth → CORS → UserHandler，测试时也要按这个顺序包装

真正难的不是写测试，是让 handler 和中间件本身可测试——比如避免直接引用全局 db 变量，改用依赖注入；否则你永远在 patch 全局状态，而不是验证逻辑。

今天关于《Golanghttptest实战教程详解》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！