Go / 系统课时

控制客户端超时与取消

控制客户端超时与取消

一次下游 HTTP 调用可能卡在建连、TLS 握手、等待响应头或读取响应体。Go 同时提供 http.Client.Timeout、http.Transport 阶段超时和 context 截止时间;关键不是把它们都设成同一个值,而是让最外层预算约束整次调用,再用阶段上限阻止某一步独占预算。

学习目标

  • 区分整体超时、Transport 阶段超时与请求 context 截止时间的作用范围。
  • 按调用链剩余预算组合超时,并理解“最先到期者生效”的规则。
  • 让取消信号沿调用链传播,避免下游请求在上游放弃后继续占用资源。

先分清三层时间限制

http.Client.Timeout 是客户端级的整次请求上限,覆盖建连、重定向、等待响应以及读取响应体;即使 Do 已返回,它仍可能在后续读响应体时触发。值为 0 表示客户端本身不设置总超时,因此不能把它误当成安全默认值。

http.Transport 更适合限制具体阶段,例如 net.Dialer.Timeout 控制建连,TLSHandshakeTimeout 控制 TLS 握手,ResponseHeaderTimeout 控制发送请求后等待响应头。IdleConnTimeout 只负责清理空闲的 keep-alive 连接,不是单次请求的执行超时。

context.WithTimeout 或 context.WithDeadline 属于请求级预算,最适合承接上游调用链的剩余时间和主动取消。一个请求同时存在多层时间限制时,最先到期的限制终止请求,后面的更长超时不会再获得执行机会。

Go HTTP 客户端三层超时与调用预算关系

按调用链预算组合配置

假设上游只剩 900 ms,而当前服务还要预留约 150 ms 做结果处理,那么下游请求的 context 预算可以控制在约 750 ms。建连、TLS、响应头等待再分别设置更短的阶段上限;Client.Timeout 可以作为略宽于正常预算的客户端级兜底,而不是和每个阶段机械设置为同一个数值。

阶段超时不需要简单相加成总预算。它们是“单阶段最多能花多久”的护栏,context 才负责“这次调用总共还能花多久”。例如响应头很快返回后,ResponseHeaderTimeout 已经完成职责,后续读取响应体仍继续受 context 和 Client.Timeout 约束。

下面的程序用同一个慢服务验证两种情况:第一请求的 context 先到期;第二请求没有额外 deadline,因此由 ResponseHeaderTimeout 先终止。

go
package main

import (
    "context"
    "errors"
    "fmt"
    "net"
    "net/http"
    "net/http/httptest"
    "time"
)

func main() {
    server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        time.Sleep(250 * time.Millisecond)
        fmt.Fprintln(w, "ok")
    }))
    defer server.Close()

    transport := &http.Transport{
        DialContext:           (&net.Dialer{Timeout: 100 * time.Millisecond}).DialContext,
        TLSHandshakeTimeout:   150 * time.Millisecond,
        ResponseHeaderTimeout: 180 * time.Millisecond,
    }
    client := &http.Client{
        Transport: transport,
        Timeout:   500 * time.Millisecond,
    }

    // 请求级预算最短,因此会早于 Transport 和 Client.Timeout 到期。
    ctx, cancel := context.WithTimeout(context.Background(), 80*time.Millisecond)
    defer cancel()
    req1, err := http.NewRequestWithContext(ctx, http.MethodGet, server.URL, nil)
    if err != nil {
        panic(err)
    }
    resp1, err := client.Do(req1)
    if resp1 != nil {
        resp1.Body.Close()
    }
    fmt.Println("context deadline:", errors.Is(err, context.DeadlineExceeded))

    req2, err := http.NewRequestWithContext(context.Background(), http.MethodGet, server.URL, nil)
    if err != nil {
        panic(err)
    }
    resp2, err := client.Do(req2)
    if resp2 != nil {
        resp2.Body.Close()
    }
    var netErr net.Error
    fmt.Println("transport phase timeout:", errors.As(err, &netErr) && netErr.Timeout())
}

预期输出

text
context deadline: true
transport phase timeout: true

示例只输出稳定的分类结果;底层错误文本可能随 Go 版本或平台略有差异。

让取消信号沿调用链传播

服务端处理请求时,应从入站 r.Context() 派生下游请求,而不是重新使用 context.Background()。这样客户端断开、上游取消或 deadline 到期后,下游的建连、等待响应和响应体读取都能尽快停止,释放连接与 goroutine。

如果调用的是长轮询、流式响应或大文件下载,固定的 Client.Timeout 可能把正常的长连接截断。此时可以让 Client.Timeout 保持为 0,改由请求 context 控制业务生命周期,并继续保留合理的建连、TLS 和响应头阶段超时。

可靠的组合通常是:调用链用 context 表达总预算与取消,Transport 防止单个网络阶段卡死,Client.Timeout 只作为是否需要的全局安全网。这样既能快速失败,也不会让多个互相重叠的超时掩盖真正的预算边界。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

控制客户端超时与取消

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通