如何在Golang中测试HTTP客户端_模拟外部API请求响应_技术教程

Go测试HTTP客户端应优先拦截传输层而非真实发请求，推荐用httptest.Server伪造服务端验证请求构造与响应处理，或用httpmock模拟多场景响应，也可手动替换Client.Transport实现轻量控制。

在 Go 中测试 HTTP 客户端，关键不是真的发请求，而是替换掉默认的 http.Client 的传输层（Transport），用 httpmock 或标准库的 httptest.Server 拦截并返回预设响应。

用 httptest.Server 伪造服务端（推荐用于集成/端到端风格）

适合验证客户端逻辑是否正确构造请求、处理状态码和 JSON 响应等，不依赖第三方库。

启动一个临时 HTTP 服务，返回你想要的响应体、状态码、Header
把客户端的 BaseURL 指向这个本地 server.URL
测试完记得调用 server.Close()

示例：

func TestMyClient_GetUser(t *testing.T) {
    server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        if r.Method != "GET" || r.URL.Path != "/users/123" {
            t.Fatal("unexpected request")
        }
        w.Header().Set("Content-Type", "application/json")
        w.WriteHeader(http.StatusOK)
        json.NewEncoder(w).Encode(map[string]interface{}{"id": 123, "name": "Alice"})
    }))
    defer server.Close()

    client := NewAPIClient(server.URL) // 把 server.URL 当作 API 地址传入
    user, err := client.GetUser(context.Background(), "123")
    if err != nil {
        t.Fatal(err)
    }
    if user.Name != "Alice" {
        t.Error("expected Alice")
    }
}

用 httpmock 模拟特定请求（适合单元测试、更轻量）

当你要覆盖多种响应场景（如 404、超时、网络错误）且不想启 HTTP 服务时，httpmock 更灵活。

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

导入 github.com/jarcoal/httpmock
在测试开始前调用 httpmock.Activate()，结束时 DeactivateAndReset()
用 httpmock.RegisterResponder() 匹配方法 + URL，返回自定义响应

示例：

func TestMyClient_GetUser_WithHttpMock(t *testing.T) {
    httpmock.Activate()
    defer httpmock.DeactivateAndReset()

    httpmock.RegisterResponder("GET", "https://api.example.com/users/456",
        httpmock.NewStringResponder(200, `{"id":456,"name":"Bob"}`))

    client := NewAPIClient("https://api.example.com")
    user, err := client.GetUser(context.Background(), "456")
    if err != nil {
        t.Fatal(err)
    }
    if user.Name != "Bob" {
        t.Error("expected Bob")
    }
}