Go的http.Client必须显式配置超时，推荐用context.WithTimeout控制请求级超时，优先级最高；Transport层需分别设置DialContext、TLSHandshakeTimeout等；错误处理需区分context超时、net.Error等类型。
Go 的 http.Client 默认不设超时，直接用会导致请求无限挂起，尤其在服务不可达或网络异常时，可能拖垮整个应用。必须显式配置超时，且要区分连接、读写等不同阶段。
设置 client 超时的三种关键方式
Go 中超时控制不是靠单个字段，而是通过 http.Client 的 Timeout、Transport 或上下文（context.Context）分别覆盖不同环节：
-
client.Timeout：仅作用于整个请求生命周期（从Do开始到响应体读完），但会掩盖底层连接/读写的细节问题 -
client.Transport中的&http.Transport{}：可精确控制DialContext（连接）、ResponseHeaderTimeout（等待 header）、ReadTimeout/WriteTimeout（已废弃，不推荐） - 传入带超时的
context.Context到client.Do(req.WithContext(ctx))：最灵活，支持取消、链路透传、动态超时
推荐写法：用 context 控制请求级超时
这是目前最主流、最可控的方式，尤其适合微服务调用或需要与上游超时对齐的场景。它不依赖 Transport 配置，也不受 client.Timeout 影响，优先级最高。
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second) defer cancel()req, _ := http.NewRequest("GET", "https://www.php.cn/link/46b315dd44d174daf5617e22b3ac94ca", nil) resp, err := http.DefaultClient.Do(req.WithContext(ctx)) if err != nil { // 注意：err 可能是 context.DeadlineExceeded if errors.Is(err, context.DeadlineExceeded) { log.Println("request timed out") } return } defer resp.Body.Close()
Transport 层超时配置的常见误区
很多人误以为设置了 Transport.ResponseHeaderTimeout 就万事大吉，其实它只管“发完请求后多久没收到 header”，不包括 DNS 解析、TCP 连接、TLS 握手、body 读取等阶段：
立即学习“go语言免费学习笔记（深入）”；
-
DialContext超时需单独封装，例如用net.Dialer{Timeout: 3 * time.Second} -
TLSHandshakeTimeout必须显式设置，否则默认 10 秒，且不被ResponseHeaderTimeout覆盖 -
IdleConnTimeout和MaxIdleConnsPerHost影响复用连接，和单次请求超时无关，但配置不当会导致连接池耗尽
一个安全的 Transport 示例：
transport := &http.Transport{
DialContext: (&net.Dialer{
Timeout: 3 * time.Second,
KeepAlive: 30 * time.Second,
}).DialContext,
TLSHandshakeTimeout: 3 * time.Second,
ResponseHeaderTimeout: 2 * time.Second,
IdleConnTimeout: 30 * time.Second,
MaxIdleConns: 100,
MaxIdleConnsPerHost: 100,
}
client := &http.Client{
Transport: transport,
// 不再设 client.Timeout，避免与 context 冲突
}
错误处理时容易忽略的 timeout 类型
Go 的 HTTP 超时错误不是统一类型，errors.Is(err, context.DeadlineExceeded) 只能捕获 context 超时；Transport 层超时（如连接失败）通常返回 *url.Error，其 Err 字段可能是 net.OpError，需用 errors.Is(err, syscall.ETIMEDOUT) 或检查 err.(net.Error).Timeout() 判断：
- context 超时 →
context.DeadlineExceeded - DNS/TCP 连接超时 →
net.Error.Timeout() == true - 等待 header 超时 → 同样是
net.Error，但发生在 response 返回后 - 读 body 超时 → 实际上 Go 标准库没有原生 body 读取超时，需手动用
io.LimitReader或time.AfterFunc包裹resp.Body
所以不要只判断一种 error，尤其在做熔断或重试逻辑时。
