使用httptest可创建模拟HTTP服务器进行Go语言测试，避免依赖真实网络。1. 通过httptest.NewServer启动本地服务器，返回自定义响应，验证客户端处理逻辑；2. 可模拟不同状态码如404、500及超时情况，确保错误处理正确；3. 结合依赖注入将baseURL作为参数传入，便于测试时替换为模拟服务器地址；4. 复杂场景可选gock等库，但多数情况httptest已足够。合理使用能提升测试稳定性与速度。
在Go语言开发中，测试网络请求时我们通常不希望真正调用外部服务。使用模拟HTTP服务器可以避免依赖真实网络环境，提高测试稳定性与速度。Golang内置的 net/http/httptest 包提供了便捷方式来创建临时HTTP服务器用于测试，下面介绍几种实用技巧。
使用 httptest 创建模拟HTTP服务器
httptest 包允许你快速启动一个本地测试服务器，它会监听一个随机端口并返回你定义的响应内容。这种方式适合测试客户端逻辑是否正确处理各种HTTP响应。
示例：模拟一个返回JSON的API：
func TestAPIClient(t *testing.T) {
// 定义模拟响应
server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(http.StatusOK)
fmt.Fprintln(w, `{"message": "hello"}`)
}))
defer server.Close()
// 使用 server.URL 作为目标地址
resp, err := http.Get(server.URL)
if err != nil {
t.Fatalf("请求失败: %v", err)
}
defer resp.Body.Close()
if resp.StatusCode != http.StatusOK {
t.Errorf("期望状态码200，实际得到 %d", resp.StatusCode)
}}
这种方式完全隔离了外部网络，所有请求都发往本地测试服务器，便于控制响应行为。
模拟不同
状态码和错误场景
状态码和错误场景真实环境中API可能返回404、500或超时。通过 httptest 可以轻松模拟这些情况，确保你的程序具备容错能力。
你可以这样测试错误处理逻辑：
server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusNotFound)
fmt.Fprintln(w, `{"error": "not found"}`)
}))
defer server.Close()
也可以模拟网络超时：
server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
time.Sleep(2 * time.Second) // 超出客户端超时时间
w.WriteHeader(http.StatusOK)
}))
defer server.Close()
client := &http.Client{Timeout: 1 time.Second}
resp, err := client.Do(&http.Request{ / ... */ })
if err != nil {
// 验证是否为超时错误
}
结合依赖注入实现更灵活的Mock
为了便于测试，建议将HTTP客户端或服务地址作为参数传入，而不是硬编码在函数内部。
例如：
type APIClient struct {
baseURL string
client *http.Client
}
func NewClient(baseURL string) APIClient {
return &APIClient{
baseURL: baseURL,
client: &http.Client{Timeout: 5 time.Second},
}
}
func (c *APIClient) GetMessage() (string, error) {
resp, err := c.client.Get(c.baseURL + "/message")
if err != nil {
return "", err
}
defer resp.Body.Close()
// 解析响应...
}
测试时传入 httptest.Server.URL 即可：
func TestGetMessage_Success(t *testing.T) {
server := httptest.NewServer(...)
defer server.Close()
client := NewClient(server.URL)
msg, err := client.GetMessage()
// 断言结果
}
使用第三方库简化复杂场景（可选）
对于需要匹配特定请求路径、方法或Header的场景，可以考虑使用如 gock 这类库，它支持声明式Mock规则。
但大多数情况下，httptest 已足够，且无需引入额外依赖。
基本上就这些。合理使用 httptest 能让你的HTTP客户端测试更可靠、快速又易于维护。关键是把服务地址抽象出来，配合测试服务器灵活控制响应内容。
