使用 httptest 进行 go web 单元测试需遵循以下步骤：1. 使用 httptest.newserver 创建测试服务器，可传入 http.handlerfunc 或完整 http.handler；2. 通过 httptest.newrequest 构造请求，结合 http.client 发送或直接用 httptest.newrecorder 记录响应；3. 验证响应状态码和 body 内容；4. 对复杂请求设置 body、header 或 query 参数。这种方式无需真实网络环境，能高效验证接口逻辑正确性。
在 Go 语言中进行 Web 开发时，单元测试是确保代码质量的重要环节。尤其是对于 HTTP 接口来说，使用 httptest 包可以方便地模拟请求和响应，从而验证接口逻辑是否正确。
如何使用 httptest 创建测试服务器
Go 标准库中的 net/http/httptest 提供了创建临时测试 HTTP 服务的能力。你可以用它来模拟一个运行的 Web 服务，然后向它发送请求进行测试。
ts := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
fmt.Fprintln(w, "hello")
}))
defer ts.Close()这样就启动了一个监听本地端口的测试服务器，你可以通过 ts.URL 获取它的地址。这个方法非常适合用来测试中间件、路由处理函数等不需要真实网络环境的场景。
立即学习“go语言免费学习笔记（深入）”；
如果你希望测试的是完整的 http.Handler（比如一个已经注册好路由的 http.ServeMux），可以直接传入：
ts := httptest.NewServer(yourMux)
构造请求并检查响应结果
有了测试服务器之后，下一步就是构造请求并验证返回内容。
通常你会使用 http.NewRequest 创建一个请求对象，然后通过客户端发送：
req := httptest.NewRequest("GET", "/some-path", nil)
resp, _ := http.DefaultClient.Do(req)或者更简单的方式是直接使用 httptest.ResponseRecorder 来记录响应内容，而不需要真正发起网络请求：
w := httptest.NewRecorder()
r := httptest.NewRequest("GET", "/users/123", nil)
yourHandlerFunc(w, r)
// 检查状态码
if w.Code != http.StatusOK {
t.Errorf("expected 200, got %d", w.Code)
}
// 检查返回内容
expected := `{"id":123,"name":"test"}`
if w.Body.String() != expected {
t.Errorf("expected body %s, got %s", expected, w.Body.String())
}这种方式效率更高，适合大多数单元测试场景。你只需要准备好请求参数和上下文，就能快速验证 handler 的行为。
测试复杂请求，比如带 Body 或 Header 的情况
有时候你需要测试 POST 请求、JSON 数据体、自定义 Header 等，这时候可以在构造请求时添加这些信息：
body := strings.NewReader(`{"username":"test","password":"123456"}`)
req := httptest.NewRequest("POST", "/login", body)
req.Header.Set("Content-Type", "application/json")
w := httptest.NewRecorder()
yourLoginHandler(w, req)
// 检查响应
if w.Code != http.StatusOK || !strings.Contains(w.Body.String(), "success") {
t.Fail()
}-
Body：如果是 JSON 请求，记得设置正确的
Content-Type。 -
Header：有些接口依赖特定头信息，比如
Authorization，不要遗漏。 -
Query 参数：可以通过 URL 字符串拼接，例如
/search?q=abc，也可以使用url.Values构造。
基本上就这些。只要掌握了这几个关键点，就可以写出结构清晰、覆盖全面的单元测试了。httptest 虽然功能不复杂，但非常实用，是 Go Web 开发测试中不可或缺的工具。
