应使用 httptest.NewServer 启动临时 HTTP 服务器并传入 handler,获取 server.URL 发起请求,且必须 defer server.Close();需精细控制请求时用 httptest.NewRequest 构造 *http.Request,配合 httptest.NewRecorder 测试 handler 行为。

用 httptest.NewServer 启动测试 HTTP 服务
别直接写 http.Get 去调真实接口——测试时应隔离外部依赖。Go 标准库的 httptest 包提供 NewServer,它会启动一个临时 HTTP 服务器,返回可访问的 URL(如 http://127.0.0.1:34212),你拿这个 URL 当目标发请求即可。
关键点:
-
NewServer接收一个http.Handler,通常传入你的业务路由(比如http.HandlerFunc或http.ServeMux) - 它自动监听随机空闲端口,无需手动选端口或处理
ListenAndServe错误 - 必须调用
server.Close()结束,否则 goroutine 和端口会泄漏
server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
if r.URL.Path == "/api/user" && r.Method == "GET" {
w.WriteHeader(http.StatusOK)
w.Write([]byte(`{"id":1,"name":"alice"}`))
}
}))
defer server.Close() // 必须加
resp, err := http.Get(server.URL + "/api/user")
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
用 httptest.NewRequest 构造请求对象
当你需要控制请求头、Body、Method、URL 查询参数等细节(比如测试登录接口带 Authorization 头),就不能只靠 http.Get。此时用 httptest.NewRequest 创建原始 *http.Request,再交给你的 handler 处理。
常见使用场景:
立即学习“go语言免费学习笔记(深入)”;
- 测试中间件(如鉴权、日志)是否正确读取 header
- 验证 JSON 请求体是否被正确解析
- 模拟不同 method(
PUT、DELETE)或 content-type
req := httptest.NewRequest("POST", "/login", strings.NewReader(`{"user":"bob","pass":"123"}`))
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer abc123")
rr := httptest.NewRecorder()
handler := http.HandlerFunc(yourLoginHandler)
handler.ServeHTTP(rr, req)
if rr.Code != http.StatusOK {
t.Errorf("expected status OK, got %d", rr.Code)
}
为什么不用 net/http/httptest 模拟客户端?
名字容易误导:httptest 的核心定位是「测试服务端逻辑」,不是模拟客户端行为。它提供的 NewRequest 和 NewRecorder 是为服务端 handler 测试服务的;NewServer 是为客户端代码提供可控后端——但它本身不封装 http.Client 行为。
也就是说:
- 你仍要用标准
http.Client发请求(如client.Do(req)) -
httptest不替代http.Client,只帮你解决「往哪发」和「怎么构造请求对象」的问题 - 若需 mock 客户端行为(如强制返回错误、延迟响应),得自己包装
http.RoundTripper,或用第三方库如gock
容易漏掉的清理和边界情况
测试中端口泄漏和 Body 未关闭是最常导致 CI 失败或本地运行变慢的问题。
-
httptest.NewServer启动后,必须配对defer server.Close(),哪怕测试 panic 也要生效,建议用defer func() { server.Close() }() - 所有
resp.Body必须显式Close(),否则连接不会释放,后续请求可能卡住 - 如果 handler 内部调用了
http.Redirect,默认不会跟随跳转,需手动检查resp.StatusCode是否为302,或用带CheckRedirect的 client -
httptest.NewRequest的 body 参数如果是strings.NewReader,记得内容要合法(比如 JSON 字符串不能少引号)
复杂点往往不在逻辑,而在这些隐式资源管理上。漏掉一次 Close(),可能让整个测试套件在并发下间歇性失败。










