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
真正难调试的，往往是 handler 里混用了全局变量、未关闭的数据库连接、或者依赖了外部时间（time.Now()）——这些 httptest 帮不上忙，得靠接口抽象和可控依赖注入。
