Go Academy · 课时

设置超时与请求头

Q: 「设置超时与请求头」这节课中我会学到什么？

客户端超时、自定义请求头与身份验证令牌 你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

客户端超时、自定义请求头与身份验证令牌

设置超时与请求头 是 CoddyKit 上的免费 Go Academy 课时。这是第 2 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Go Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Go Academy 课程共包含 4 节课。

客户端级别超时

设置 http.Client.Timeout，限制请求和响应的总耗时。这是最容易配置的超时。

client := &http.Client{Timeout: 10 * time.Second}

传输级别超时

请通过 http.Transport 微调连接建立和 TLS 握手的超时时间：

t := &http.Transport{
    DialContext: (&net.Dialer{
        Timeout:   5 * time.Second,
        KeepAlive: 30 * time.Second,
    }).DialContext,
    TLSHandshakeTimeout:   5 * time.Second,
    ResponseHeaderTimeout: 5 * time.Second,
}
client := &http.Client{Transport: t, Timeout: 30 * time.Second}

基于上下文的超时

上下文超时针对单个请求，并会传播到下游调用。当截止时间到达时，它会取消请求。

ctx, cancel := context.WithTimeout(context.Background(), 3*time.Second)
defer cancel()
req, _ := http.NewRequestWithContext(ctx, "GET", url, nil)

设置请求头

使用 req.Header.Set（替换）或 req.Header.Add（追加）向请求添加请求头：

req.Header.Set("Authorization", "Bearer "+token)
req.Header.Set("Accept", "application/json")
req.Header.Set("X-Request-ID", requestID)

常用请求头

Content-Type 用于请求体；Accept 用于指定所需的响应格式；Authorization 用于身份验证令牌；User-Agent 用于标识客户端。

读取响应头

从 resp.Header.Get(key) 中读取响应头：

contentType := resp.Header.Get("Content-Type")
retryAfter := resp.Header.Get("Retry-After")

空闲连接超时

请在传输层设置 IdleConnTimeout 以关闭空闲连接，防止流量下降时连接不断累积。

t.IdleConnTimeout = 90 * time.Second
t.MaxIdleConnsPerHost = 10

TLS 配置

请通过传输层上的 tls.Config 自定义 TLS（最低版本、客户端证书）：

t.TLSClientConfig = &tls.Config{MinVersion: tls.VersionTLS12}

检测超时错误

使用 errors.As 区分超时错误和网络错误：

var urlErr *url.Error
if errors.As(err, &urlErr) && urlErr.Timeout() {
    // handle timeout
}

每个请求的超时与客户端超时

Client.Timeout 适用于每个请求。上下文超时针对单个请求，并且可以短于客户端超时。两者都会生效 — 以较短的超时时间为准。

禁用保持连接

对于只打开少量连接的短期运行程序，请在传输层设置 DisableKeepAlives: true，以避免连接池带来的开销。

快速检查

同时设置 http.Client.Timeout 和上下文超时时，哪个会生效？

回顾：超时与标头

要点：

client.Timeout：每个请求的总超时时间
context.WithTimeout：可取消且可传播的超时
使用 req.Header.Set 设置自定义标头
使用 Transport 精细控制 TLS、拨号和空闲超时

常见问题解答

「设置超时与请求头」课时是免费的吗？

是的 — 「设置超时与请求头」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Go Academy 课程的其余内容，请升级到 CoddyKit PRO。 Go Academy 课程共包含 4 节课。

「设置超时与请求头」这节课中我会学到什么？

客户端超时、自定义请求头与身份验证令牌你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Go Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Go Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 2 节课，共 4 节。

「设置超时与请求头」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Go Academy 课中编写并运行代码吗？

能。每节 Go Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Go Academy