Golang HTTP客户端测试应避免依赖真实服务，优先使用httptest.Server模拟后端或自定义RoundTripper隔离网络，结合接口抽象与依赖注入，分别验证请求构造、响应处理和错误应对逻辑。
直接用真实HTTP服务测试客户端逻辑，既慢又不可靠。Golang提供了http/httptest和net/http/httputil等标准库工具，配合接口抽象和依赖注入，能高效、隔离地验证HTTP客户端行为——重点不是“能不能发请求”，而是“是否按预期构造请求、处理响应、应对错误”。
用 httptest.Server 模拟后端服务
这是最常用也最实用的方式。它启动一个轻量级本地HTTP服务器，可完全控制响应状态码、Header、Body，还能记录收到的请求用于断言。
- 创建 server：用
httptest.NewServer启动，它返回带 URL 的 server 实例，记得在测试结束时调用server.Close() - 把 client 的 BaseURL 或 Transport 指向该 server：比如 client 初始化时传入
server.URL，或替换默认 Transport（用于测试重试、超时等底层行为） - 示例：验证 client 是否正确设置 Authorization Header
server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
if r.Header.Get("Authorization") != "Bearer test-token" {
w.WriteHeader(http.StatusUnauthorized)
return
}
w.WriteHeader(http.StatusOK)
}))
defer server.Close()
client := NewClient(server.URL, "test-token")
resp, err := client.DoSomething()
// 断言 resp.StatusCode == 200
用 http.RoundTripper 替换实现，彻底隔离网络
当需要精确控制每一次 RoundTrip 行为（比如模拟超时、重定向、连接拒绝），或不想启动 HTTP 服务时，可自定义 http.RoundTripper。它比 mock 更轻、更贴近真实流程。
立即学习“go语言免费学习笔记（深入）”；
- 实现一个结构体，满足
RoundTrip(*http.Request) (*http.Response, error)方法 - 在 client 初始化时，通过
&http.Client{Transport: yourMockTransport}注入 - 适合测试：超时逻辑、重试次数、错误分类（net.Error vs API error）、请求重写（如加签名）
type MockTransport struct {
Resp *http.Response
Err error
}
func (m *MockTransport) RoundTrip(req *http.Request) (*http.Response, error) {
return m.Resp, m.Err
}
client := &http.Client{Transport: &MockTransport{
Resp: &http.Response{StatusCode: 201, Body: io.NopCloser(strings.NewReader(`{"id":1}`))},
}}
对 client 接口抽象 + 依赖注入
让 client 本身依赖接口而非具体实现，是可测性的基础。例如定义 HTTPDoer 接口，让业务逻辑只依赖它，测试时注入 mock 或 test transport。
- 避免在函数内部 new http.Client；改为接收 client 实例或 doer 接口
- 典型接口：
type HTTPDoer interface { Do(*http.Request) (*http.Response, error) } - 业务函数签名从
func Process() error改为func Process(doer HTTPDoer) error，测试时传入可控实现
验证请求内容与响应解析逻辑分离
HTTP 客户端测试常混淆“请求是否发出”和“数据是否正确解析”。应拆开验证：
- 用
httptest或 mock transport 验证请求 URL、Method、Header、Body 是否符合预期（可借助httputil.DumpRequestOut打印调试） - 单独写单元测试验证 JSON 解析、错误映射、重试条件判断等纯逻辑，输入固定字节流，不走网络
- 例如：给定
{"code":401,"msg":"unauthorized"}，检查 client 是否返回特定 error 类型
基本上就这些。核心是别让测试依赖外部服务，用标准库工具构建可控边界，再配合接口抽象，HTTP 客户端逻辑就能测得快、测得稳、改得放心。
