超时错误本质是实现了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 还没真正生效。
立即学习“go语言免费学习笔记（深入）”；
-
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 的一次性语义——这两个点不处理，超时逻辑就形同虚设。
