测试Go中HTTP客户端请求的关键是避免真实网络调用，1. 使用httptest.Server模拟完整HTTP服务，适合集成测试；2. 自定义RoundTripper实现零网络调用，适用于单元测试；3. 引入gock等库简化复杂场景的模拟，提升可读性与效率。
测试 Go 中的 HTTP 客户端请求，关键在于避免真实网络调用，通过模拟 HTTP 服务或 RoundTripper 来控制响应。这样既能保证测试的稳定性，又能覆盖各种异常情况。
使用 httptest.Server 模拟后端服务
最直观的方式是用 net/http/httptest 启动一个临时 HTTP 服务器，用来模拟外部 API 的行为。
这种方式适合测试客户端与完整 HTTP 服务交互的场景。
func TestHTTPClient_GetUserData(t *testing.T) {
// 创建模拟服务器
server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
if r.URL.Path == "/user/123" {
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(http.StatusOK)
fmt.Fprint(w, `{"id": "123", "name": "Alice"}`)
} else {
w.WriteHeader(http.StatusNotFound)
}
}))
defer server.Close()
// 构造客户端并发送请求
client := &http.Client{}
resp, err := client.Get(server.URL + "/user/123")
if err != nil {
t.Fatalf("请求失败: %v", err)
}
defer resp.Body.Close()
if resp.StatusCode != http.StatusOK {
t.Errorf("期望状态码 200，实际: %d", resp.StatusCode)
}
var user struct {
ID string `json:"id"`
Name string `json:"name"`
}
if err := json.NewDecoder(resp.Body).Decode(&user); err != nil {
t.Fatalf("解析 JSON 失败: %v", err)
}
if user.Name != "Alice" {
t.Errorf("期望名字 Alice，实际: %s", user.Name)
}
}
立即学习“go语言免费学习笔记（深入）”；
替换 Transport 实现零网络调用
更轻量的方法是自定义 http.Transport 或实现 RoundTripper 接口，直接拦截请求并返回预设响应。
适用于单元测试中需要精确控制请求/响应，且不希望有任何网络开销的情况。
type mockRoundTripper struct{}
func (m *mockRoundTripper) RoundTrip(req *http.Request) (*http.Response, error) {
body := `{"status": "ok"}`
resp := &http.Response{
StatusCode: http.StatusOK,
Body: io.NopCloser(strings.NewReader(body)),
Header: make(http.Header),
Request: req,
}
return resp, nil
}
func TestClient_WithMockTransport(t *testing.T) {
client := &http.Client{
Transport: &mockRoundTripper{},
}
resp, err := client.Get("https://api.example.com/health")
if err != nil {
t.Fatal(err)
}
defer resp.Body.Close()
if resp.StatusCode != http.StatusOK {
t.Errorf("期望 200，实际 %d", resp.StatusCode)
}
}
这种方式完全脱离网络，执行速度快，便于构造超时、500 错误等边界情况。
使用第三方库简化测试（如 gock）
如果项目频繁测试 HTTP 客户端，可以引入 gock 这类专门用于 HTTP 模拟的库，语法更简洁。
import "gopkg.in/h2non/gock.v1"
func TestWithGock(t *testing.T) {
defer gock.Off() // 确保清理
gock.New("https://api.example.com").
Get("/users/1").
Reply(200).
JSON(map[string]string{"name": "Bob"})
client := &http.Client{}
resp, _ := client.Get("https://api.example.com/users/1")
defer resp.Body.Close()
// 验证 gock 断言
if !gock.IsDone() {
t.Error("预期请求未发生")
}
}
gock 支持匹配 URL、方法、头、参数甚至请求体，适合复杂场景。
基本上就这些。选择哪种方式取决于测试粒度和依赖程度。小范围单元测试推荐 mock RoundTripper，集成测试可用 httptest.Server，追求效率和可读性可选 gock。
