Golang超时处理技巧与实战分享

本篇文章向大家介绍《Golang超时错误处理技巧分享》，主要包括，具有一定的参考价值，需要的朋友可以参考一下。

超时错误本质是实现了net.Error接口的值，需用类型断言+Timeout()判断；http.Client超时须分Timeout、DialContext、TLSHandshakeTimeout三类设置；SetDeadline具有一一次性语义且读写独立，应每次I/O前显式设置。

超时错误本质是 net.Error，不是普通 error

Go 的网络操作（如 http.Get、conn.Read）在超时时返回的错误类型是实现了 net.Error 接口的值，它有 Timeout() 和 Temporary() 方法。直接用 errors.Is(err, context.DeadlineExceeded) 或 strings.Contains(err.Error(), "timeout") 都不可靠——前者只适用于 context 取消路径，后者易误判。

正确做法是类型断言后调用 Timeout()：

if netErr, ok := err.(net.Error); ok && netErr.Timeout() {
    // 真正的网络超时
}

注意：不是所有超时都走这个分支。比如 http.Client 设置了 Timeout 字段后，底层会用 context.WithTimeout，此时错误是 context.DeadlineExceeded，需单独判断。

http.Client 超时必须分三类设置

HTTP 客户端超时不能只设一个 Timeout 字段就完事。它实际控制的是整个请求生命周期（从 Do 开始到响应体读完），但很多问题出在连接建立或 TLS 握手阶段，这时 Timeout 还没真正生效。

• Timeout：覆盖整个请求（含 DNS 解析、连接、TLS、发送、接收 header + body）——但若连接卡死在 TCP SYN 重传，可能远超该值
• Transport.DialContext 需配合 net.Dialer.Timeout 和 KeepAlive 控制建连耗时
• Transport.TLSClientConfig.HandshakeTimeout 单独限制 TLS 握手时间（默认 10 秒，常被忽略）

典型安全配置：

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

自定义 net.Conn 超时要避免 SetDeadline 误用

手动调用 conn.SetDeadline 是常见写法，但容易踩两个坑：

• 它是一次性生效的：设置后只影响下一次读/写，之后需重新调用；否则后续 I/O 不受控
• 读写 deadline 独立：SetReadDeadline 不影响写，反之亦然；HTTP 流水线或长连接场景下必须分别设置

更稳妥的方式是用 conn.SetReadDeadline + conn.SetWriteDeadline 在每次 I/O 前显式设置，或直接使用带上下文的 conn.Read/Write 方法（Go 1.19+ 支持 ReadMsgUDPContext 等，但通用 net.Conn 仍需手动管理 deadline）。

并发请求中用 context.WithTimeout 比全局超时更精准

当发起多个 HTTP 请求（如批量调用第三方 API），用单个 http.Client.Timeout 无法区分每个请求的截止时间。此时应为每个请求构造独立 context.Context：

ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()
req, _ := http.NewRequestWithContext(ctx, "GET", url, nil)
resp, err := client.Do(req)

这样即使某个请求慢，也不会拖垮其他请求；且 err 可直接用 errors.Is(err, context.DeadlineExceeded) 判断。

注意：context.WithTimeout 创建的 ctx 必须在请求结束后调用 cancel()，否则 goroutine 泄漏。如果请求已结束但 cancel 未调用，定时器仍在运行。

最常被忽略的是 TLS 握手超时和 SetDeadline 的一次性语义——这两个点不处理，超时逻辑就形同虚设。

以上就是《Golang超时处理技巧与实战分享》的详细内容，更多关于的资料请关注golang学习网公众号！