使用httptest模拟延迟响应，验证客户端超时；2. 通过自定义Transport设置DialContext等参数，测试连接、读写阶段超时；3. 利用context控制连接挂起，触发并检查超时错误类型，确保客户端超时逻辑正确。
在Golang中测试网络请求超时，关键在于控制客户端的超时行为，并通过模拟服务端延迟来验证超时是否按预期触发。下面介绍几种实用方法。
使用 net/http/httptest 模拟延迟响应
Go 的 httptest 包可以快速搭建本地HTTP服务，用于模拟慢响应或超时场景。
你可以让测试服务器故意延迟返回，观察客户端是否会因超时而中断请求。
示例代码：func TestHTTPRequestTimeout(t *testing.T) {
// 模拟一个延迟500ms才返回的服务器
server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
time.Sleep(600 * time.Millisecond) // 延迟超过客户端设置的超时时间
w.WriteHeader(http.StatusOK)
w.Write([]byte("hello"))
}))
defer server.Close()
// 创建带超时的 HTTP 客户端
client := &http.Client{
Timeout: 500 * time.Millisecond,
}
// 发起请求
resp, err := client.Get(server.URL)
if err != nil {
// 预期错误：请求应因超时失败
if netErr, ok := err.(net.Error); ok && netErr.Timeout() {
return // 测试通过
}
t.Fatalf("expected timeout error, got: %v", err)
}
defer resp.Body.Close()
t.Fatal("expected request to timeout, but got a response")
}
自定义 Transport 控制连接级别超时
除了整体请求超时，你还可以测试更细粒度的超时，比如连接、读写等阶段。
立即学习“go语言免费学习笔记（深入）”；
通过设置 http.Transport 的各项超时参数，能更精确地控制和测试不同阶段的行为。
建议设置以下字段：
- DialContext：控制建立连接的超时
- ResponseHeaderTimeout：控制等待响应头的超时
- ExpectContinueTimeout：控制 expect-continue 的等待时间
测试时可结合这些设置，模拟特定阶段卡住的情况。
使用 DialContext 模拟连接挂起
如果你想测试“连接无法建立”的超时（如服务器无响应），可通过自定义 DialContext 来实现。
让 dial 过程永远不返回，直到超时触发。
示例：func TestConnectionTimeout(t *testing.T) {
listener, err := net.Listen("tcp", "127.0.0.1:0")
if err != nil {
t.Fatal(err)
}
// 不接受任何连接，导致连接阻塞
// 记下监听地址
addr := listener.Addr().String()
listener.Close()
client := &http.Client{
Timeout: 1 * time.Second,
Transport: &http.Transport{
DialContext: func(ctx context.Context, network, addr string) (net.Conn, error) {
// 模拟连接一直挂起
<-ctx.Done() // 等待上下文取消
return nil, ctx.Err()
},
},
}
_, err = client.Get("http://" + addr)
if err == nil {
t.Fatal("expected error, got none")
}
if !strings.Contains(err.Error(), "context deadline exceeded") {
t.Fatalf("expected timeout, got: %v", err)
}
}
总结常见超时测试要点
测试网络请求超时时，重点是构造可控的慢服务或无响应服务，并确保客户端配置了合理的超时策略。
- 使用 httptest 模拟延迟响应，验证整体超时
- 通过自定义 Transport 测试连接、读写等阶段超时
- 利用 context 和 DialContext 模拟连接失败或长时间挂起
- 检查错误类型，确认是超时错误而非其他网络问题
基本上就这些。只要能控制服务端行为，就能有效验证客户端的超时逻辑是否健壮。
