Go语言httptest包提供两种HTTP测试方式：1. NewServer启动临时服务，适合需真实客户端调用的集成测试；2. NewRequest+NewRecorder模拟请求响应，适合快速可控的单元测试，支持中间件、路由框架及JSON/表单等请求体测试。
Go 语言自带的 net/http/httptest 包是测试 HTTP 接口最轻量、最可靠的方式，无需启动真实服务器，就能完整模拟请求与响应流程。
用 httptest.NewServer 启动临时测试服务
适合需要真实 HTTP 客户端（如 http.Client）发起请求的场景，比如测试 SDK、外部调用逻辑或集成行为。
- 它会自动监听一个空闲端口，返回一个可关闭的
*httptest.Server - 服务内部使用你提供的
http.Handler（可以是路由 mux、自定义 handler，甚至整个 Gin/Echo 实例） - 务必在测试结束前调用
server.Close()，避免端口泄漏
示例：
func TestAPIWithRealClient(t *testing.T) {
handler := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
if r.URL.Path == "/users" && r.Method == "GET" {
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(http.StatusOK)
json.NewEncoder(w).Encode([]map[string]string{{"name": "Alice"}})
}
})
server := httptest.NewServer(handler)
defer server.Close() // 关键：释放端口和资源
resp, err := http.Get(server.URL + "/users")
if err != nil {
t.Fatal(err)
}
defer resp.Body.Close()
if resp.StatusCode != http.StatusOK {
t.Errorf("expected 200, got %d", resp.StatusCode)
}
}
用 httptest.NewRequest + httptest.NewRecorder 模拟单次请求
适合单元测试 handler 函数本身，不依赖网络，执行快、可控性强，是绝大多数接口逻辑测试的首选方式。
立即学习“go语言免费学习笔记（深入）”；
-
httptest.NewRequest构造任意方法、路径、Header、Body 的请求对象 -
httptest.NewRecorder替代真实 ResponseWriter，捕获状态码、Header、响应体等全部输出 - 直接把 request 和 recorder 传给你的 handler 调用即可
示例：
func TestUserHandler(t *testing.T) {
req := httptest.NewRequest("GET", "/users/123", nil)
w := httptest.NewRecorder()
handler := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
id := strings.TrimPrefix(r.URL.Path, "/users/")
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(http.StatusOK)
json.NewEncoder(w).Encode(map[string]string{"id": id, "name": "Bob"})
})
handler.ServeHTTP(w, req)
if w.Code != http.StatusOK {
t.Errorf("expected status 200, got %d", w.Code)
}
var result map[string]string
if err := json.Unmarshal(w.Body.Bytes(), &result); err != nil {
t.Fatal(err)
}
if result["id"] != "123" {
t.Error("expected id '123'")
}
}
测试带中间件或路由框架的接口
无论是 Gorilla Mux、Chi 还是 Gin，只要最终暴露的是 http.Handler，就能用 NewRequest + NewRecorder 测试。
- Gin 示例：用
gin.CreateTestContext(w, req)获取上下文后调用c.Next()或engine.ServeHTTP() - Chi/Gorilla：直接将
chi.NewMux()或mux.NewRouter()作为 handler 传入ServeHTTP - 注意：注册路由后，确保请求路径与路由规则完全匹配（包括 trailing slash）
处理 JSON 请求体和表单数据
测试 POST/PUT 接口时，需正确设置 Body 和 Content-Type。
- JSON：用
bytes.NewReader(jsonBytes)构造 body，并设置req.Header.Set("Content-Type", "application/json") - 表单：用
url.Values{"key": {"value"}}.Encode()，并设为"application/x-www-form-urlencoded" - 文件上传可结合
multipart.Writer构造复杂 body，但多数场景用 JSON 或表单已足够
不复杂但容易忽略。
