如何在Golang中测试网络请求超时-Golang-PHP中文网

如何在Golang中测试网络请求超时

P粉602998670

发布： 2025-10-08 16:17:01

原创

231人浏览过

使用httptest模拟延迟响应，验证客户端超时；2. 通过自定义Transport设置DialContext等参数，测试连接、读写阶段超时；3. 利用context控制连接挂起，触发并检查超时错误类型，确保客户端超时逻辑正确。

如何在golang中测试网络请求超时

在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()
<pre class="brush:php;toolbar:false;"><pre class="brush:php;toolbar:false;">// 创建带超时的 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 的各项超时参数，能更精确地控制和测试不同阶段的行为。

面试猫

AI面试助手，在线面试神器，助你轻松拿Offer

查看详情

建议设置以下字段：

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()
<pre class="brush:php;toolbar:false;"><pre class="brush:php;toolbar:false;">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)
}

登录后复制

}