如何使用Golang模拟HTTP请求_Golang httptest包实践技巧_技术教程

httptest包不能发真实HTTP请求，因其绕过网络栈直接调用handler并将响应写入内存Recorder；NewServer虽启真实服务，但仅用于客户端测试而非模拟请求。

为什么 httptest 包不能发真实 HTTP 请求

httptest 是 Go 标准库中专为测试 HTTP 处理器设计的包，它不走网络栈，也不依赖本地端口或 DNS。它的核心是把 http.Handler 当作纯函数调用：你给它一个 *http.Request，它直接调用你的 handler 函数，并把响应写入内存中的 *httptest.ResponseRecorder。所以它压根不会发出真实请求，也不能用来“模拟客户端行为”。

常见误解是以为 httptest.NewServer 或 httptest.NewUnstartedServer 能替代 http.Client —— 实际上它们只是帮你快速启动一个本地监听服务（绑定随机端口），方便你用真实 http.Client 去连，本质仍是端到端测试，不是“模拟请求”的工具。

想测自己写的 http.HandlerFunc 逻辑？用 httptest.NewRequest + httptest.NewRecorder
想测整个 HTTP 服务（含中间件、路由、TLS）？用 httptest.NewServer 搭配真实 http.Client
想模拟第三方 API 调用？别碰 httptest，该用 httpmock 或接口抽象+依赖注入

用 httptest.NewRequest 构造不同场景的请求

httptest.NewRequest 是构造测试用 *http.Request 的最简方式，但要注意它默认不设 Host、Content-Length 和 Content-Type，而很多 handler（比如 Gin/echo 的路径参数解析、JSON 解析）会依赖这些字段。

例如，不设 Content-Type: application/json，json.Decode(r.Body) 可能静默失败；不设 Host，基于 Host 的路由或 CORS 判断可能出错。

立即学习“go语言免费学习笔记（深入）”；

req := httptest.NewRequest("POST", "/api/users", strings.NewReader(`{"name":"alice"}`))
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer abc123")
req.Host = "example.com"

GET 请求带 query 参数？用 url.Values 构建并附加到 URL： u := url.URL{Path: "/search", RawQuery: url.Values{"q": []string{"go"}}.Encode()}
上传文件？用 multipart.Writer 写入 bytes.Buffer，再传给 httptest.NewRequest
需要 Cookie？用 req.AddCookie(&http.Cookie{Name: "session", Value: "abc"})

用 httptest.NewRecorder 捕获响应细节

httptest.NewRecorder 返回一个实现了 http.ResponseWriter 接口的记录器，它把状态码、Header、Body 全部存进内存，不发送给客户端。但要注意：它不会自动设置 Content-Length，也不会触发 WriteHeader 的隐式调用（即第一次 Write 会默认写 200 OK）。

这意味着如果你 handler 里只写了 w.Write([]byte("ok")) 没调 w.WriteHeader(201)，rec.Code 就是 200，不是你预期的 201 —— 这在测试 RESTful 状态码时容易漏判。

rec := httptest.NewRecorder()
handler.ServeHTTP(rec, req)
if rec.Code != http.StatusCreated {
t.Errorf("expected status %d, got %d", http.StatusCreated, rec.Code)
}
if rec.Header().Get("Content-Type") != "application/json" {
t.Errorf("expected json content-type")
}
body := rec.Body.String() // 注意：Body 是 *bytes.Buffer，String() 安全

检查 Header 必须用 rec.Header()，不是 rec.HeaderMap（后者是内部字段，不反映最终写入结果）
读取 Body 后，rec.Body 不会重置，多次调用 String() 得到相同结果
如果 handler 调用了 http.Redirect，rec.Code 是 302，且 Location 在 Header 中，Body 为空

httptest.NewServer 的生命周期与端口冲突风险

httptest.NewServer 启动一个真实 HTTP server，绑定系统随机空闲端口，返回一个 *httptest.Server。它适合集成测试，但必须手动 Close()，否则 goroutine 和端口会泄漏，CI 环境跑多次后可能因端口耗尽失败。

更隐蔽的问题是：它默认使用 http.DefaultServeMux，如果你的测试代码里全局注册了其他 handler（比如 http.HandleFunc("/health", ...)），它们会意外生效，污染测试隔离性。

srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
    w.WriteHeader(http.StatusOK)
    w.Write([]byte("test"))
}))
defer srv.Close() // 必须 defer，否则端口不释放
// 用真实 client 发起请求
resp, err := http.Get(srv.URL + "/")
if err != nil {
t.Fatal(err)
}

不
要在多个测试间复用同一个 *httptest.Server，每个测试应有自己的实例
若需自定义 mux（避免全局污染），用 httptest.NewUnstartedServer + 手动 srv.Start()
在 Windows 或某些容器环境，NewServer 可能因防火墙或权限卡住，可加超时：srv.Config.ReadTimeout = 1 * time.Second