Go 的 http.Client 默认无超时，必须显式设置；推荐优先使用顶层 Timeout 字段（如 10 秒），覆盖全链路；仅当需动态控制或统一上下文时才用 context.WithTimeout()。
Go 的 http.Client 默认不超时，必须显式设置
Go 标准库的 http.Client 实例默认没有超时限制，一旦后端卡住或网络异常，Do() 会无限阻塞。这不是 bug，而是设计选择——把控制权完全交给使用者。实际生产中必须为每个请求设置超时，否则容易引发 goroutine 泄漏和连接堆积。
关键不是“要不要设”，而是“在哪设、设几层”。HTTP 超时有多个阶段，对应不同 time.Duration 字段：
-
Timeout：从调用Do()开始，到响应体读完为止的总耗时（推荐优先使用） -
Transport中的DialContext、TLSHandshakeTimeout、ResponseHeaderTimeout等：用于更精细控制（如仅限制建连或首包头时间）
多数场景下，直接设 Timeout 就够用；只有在需要区分“连不上”和“连上了但处理慢”时，才拆解配置 Transport。
http.Client{Timeout: time.Second * 10} 是最简可靠的写法
这是绝大多数 HTTP 请求应采用的初始化方式。它覆盖 DNS 解析、TCP 建连、TLS 握手、请求发送、响应头接收、响应体读取全过程，语义清晰且不易遗漏。
立即学习“go语言免费学习笔记（深入）”；
client := &http.Client{
Timeout: 10 * time.Second,
}
resp, err := client.Get("https://www.php.cn/link/46b315dd44d174daf5617e22b3ac94ca")
if err != nil {
// 这里会捕获 context.DeadlineExceeded 或 net/http: request canceled
log.Printf("request failed: %v", err)
return
}
defer resp.Body.Close()注意：Timeout 是 http.Client 的顶层字段，它内部会自动基于该值构造一个带 deadline 的 context.Context，无需手动传 context.WithTimeout() —— 除非你需要在请求发出前就取消（比如用户主动中断）。
用 context.WithTimeout() 替代 Timeout 仅当需动态控制
如果超时时间依赖运行时参数（如根据 URL 路径分级限流）、或需与其它操作共用同一个 context（如整个 RPC 链路统一超时），那就该用 context.WithTimeout() 显式传入 Do()：
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()
<p>req, _ := http.NewRequestWithContext(ctx, "GET", "<a href="https://www.php.cn/link/46b315dd44d174daf5617e22b3ac94ca">https://www.php.cn/link/46b315dd44d174daf5617e22b3ac94ca</a>", nil)
resp, err := client.Do(req) // client.Timeout 被忽略，以 ctx 为准
if err != nil {
if errors.Is(err, context.DeadlineExceeded) {
log.Println("request timed out")
}
return
}常见陷阱：
- 忘记调用
cancel()→ context 泄漏，尤其在循环中创建大量临时 context 时 - 误以为
client.Timeout和context.WithTimeout()可叠加 → 实际以更短的那个为准，且后者优先级更高 - 对重定向（
CheckRedirect）或重试逻辑未做 timeout 统一管理 → 可能导致总耗时远超预期
别忽略 io.ReadFull 或 json.Decoder.Decode 的隐式阻塞
即使设置了 client.Timeout，如果响应体很大且你用 io.ReadAll(resp.Body) 或逐字节读取，而服务端是流式返回（如 SSE、大文件下载），仍可能卡在读 body 阶段。因为 Timeout 只保证 Do() 返回，不保证后续 Read() 不超时。
解决方法是给 resp.Body 加上读超时（适用于已知响应结构的小数据）：
resp, err := client.Do(req)
if err != nil { return }
<p>// 为 Body 设置读超时（需确保底层 conn 支持 SetReadDeadline）
if rc, ok := resp.Body.(interface{ SetReadDeadline(time.Time) error }); ok {
_ = rc.SetReadDeadline(time.Now().Add(3 * time.Second))
}
defer resp.Body.Close()更健壮的做法是用 io.LimitReader 限制最大读取字节数，或用 json.NewDecoder 配合 context 控制解析过程（需封装自定义 io.Reader）。这类细节往往在线上压测或弱网环境下才暴露。
