本文介绍如何通过接口抽象和自定义结构体实现对 http.Client.Do 方法的轻量级单元测试模拟，无需第三方库，符合 Go 的接口优先设计哲学。
本文介绍如何通过接口抽象和自定义结构体实现对 `http.client.do` 方法的轻量级单元测试模拟，无需第三方库，符合 go 的接口优先设计哲学。
在 Go 中进行 HTTP 客户端行为的单元测试时，最佳实践是面向接口编程，而非直接依赖 *http.Client。你已正确定义了 HttpClient 接口：
type HttpClient interface {
Do(req *http.Request) (*http.Response, error)
}这为测试提供了天然的可插拔性——任何实现了 Do 方法的类型均可作为替代实现。
✅ 推荐方案：手写轻量 Mock 结构体（零依赖）
无需引入 gock 等仅覆盖 Get/Post 的 HTTP 拦截库（它们工作在 Transport 层，无法直接模拟 Do 行为），而是直接实现接口：
type ClientMock struct {
Response *http.Response
Err error
}
func (m *ClientMock) Do(req *http.Request) (*http.Response, error) {
// 可选：验证请求是否符合预期（如 URL、Header、Auth）
if req.URL.String() != "http://localhost:8080/api/overview" {
return nil, fmt.Errorf("unexpected request URL: %s", req.URL)
}
if user, pass, ok := req.BasicAuth(); !ok || user != "testuser" || pass != "testpass" {
return nil, fmt.Errorf("basic auth mismatch")
}
// 返回预设响应（注意：需设置 Body 为 io.ReadCloser）
if m.Response == nil {
m.Response = &http.Response{
StatusCode: 200,
Body: io.NopCloser(strings.NewReader(`{"status":"ok"}`)),
Header: make(http.Header),
}
}
return m.Response, m.Err
}在测试中使用：
func TestGetOverview(t *testing.T) {
mockClient := &ClientMock{
Response: &http.Response{
StatusCode: 200,
Body: io.NopCloser(strings.NewReader(`{"version":"1.0"}`)),
},
Err: nil,
}
overview := &Overview{
Config: Config{Url: "http://localhost", Port: "8080", User: "testuser", Password: "testpass"},
}
result, err := GetOverview(mockClient, overview)
if err != nil {
t.Fatal(err)
}
// 断言 result 字段...
}⚠️ 注意事项
-
http.Response.Body必须是io.ReadCloser类型，不可为nil或普通[]byte；常用io.NopCloser(strings.NewReader(...))包装。 - 若需模拟错误场景，直接在
ClientMock.Err中赋值即可，Do方法将原样返回。 - 避免在生产代码中使用
http.DefaultClient—— 始终通过参数注入HttpClient，保障可测性。 - 如需更复杂的模拟逻辑（如按请求路径返回不同响应），可在
Do方法内添加路由判断，无需外部库。
这种基于接口的模拟方式简洁、可控、无副作用，是 Go 生态中被广泛采纳的标准测试模式。
