最推荐方式是结合 context.Context 与 net/http 原生超时支持：用 context.WithTimeout 控制请求生命周期，配合 http.Transport 各项底层超时（如 DialContext、TLSHandshakeTimeout）协同工作，并务必调用 cancel() 防泄漏。
Go 语言中处理网络请求超时，最推荐的方式是结合 context.Context 和标准库（如 net/http）的原生超时支持。核心思路是：用 context 控制请求生命周期，让 HTTP 客户端感知取消信号，从而主动中止阻塞操作。
使用 context.WithTimeout 构建带超时的上下文
这是最常用也最直观的方式。你为每次请求创建一个带截止时间的 context，传给 HTTP 客户端，一旦超时，context.Done() 会被关闭，客户端会收到取消信号并退出。
示例：
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second) defer cancel() // 防止 goroutine 泄漏req, err := http.NewRequestWithContext(ctx, "GET", "https://www.php.cn/link/46b315dd44d174daf5617e22b3ac94ca", nil) if err != nil { log.Fatal(err) }
client := &http.Client{} resp, err := client.Do(req) if err != nil { if errors.Is(err, context.DeadlineExceeded) { log.Println("请求超时") } else { log.Printf("请求失败: %v", err) } return } defer resp.Body.Close()
注意：context.WithTimeout 返回的 cancel 函数必须调用（哪怕成功），否则可能泄漏定时器资源。
立即学习“go语言免费学习笔记（深入）”；
配置 HTTP Client 的 Transport 超时（底层连接控制）
仅靠 context 超时还不够——它无法中断 DNS 解析、TCP 连接建立或 TLS 握手等底层阻塞阶段（尤其在 Go 1.19 之前）。因此，建议同时设置 http.Transport 的各项超时字段：
- DialContext：控制建立 TCP 连接的最大耗时
- TLSHandshakeTimeout：控制 TLS 握手超时
- ResponseHeaderTimeout：从发送请求到收到响应头的最长等待时间
- IdleConnTimeout / KeepAlive：管理空闲连接复用
推荐配置示例：
transport := &http.Transport{
DialContext: (&net.Dialer{
Timeout: 5 * time.Second,
KeepAlive: 30 * time.Second,
}).DialContext,
TLSHandshakeTimeout: 5 * time.Second,
ResponseHeaderTimeout: 5 * time.Second,
IdleConnTimeout: 30 * time.Second,
MaxIdleConns: 100,
MaxIdleConnsPerHost: 100,
}
client := &http.Client{
Transport: transport,
Timeout: 10 * time.Second, // 整体请求超时（含重定向）
}
⚠️ 注意：Client.Timeout 是对 Do() 的兜底超时，但它不参与 context 取消链，且在重定向时会重新计时；而 transport 级超时更精细、更底层，与 context 协同效果更好。
避免常见陷阱
-
不要混用多个超时机制却不协调：比如同时设了
Client.Timeout、context.WithTimeout和Transport.DialContext，但值相差过大，容易导致行为不可预期（例如 context 已取消，但底层连接还在等 DNS） - 不要忽略 cancel() 调用：即使请求成功，也要执行 defer cancel()，否则 context 定时器不会释放
-
错误判断要具体：用
errors.Is(err, context.DeadlineExceeded)判断是否为 context 超时，而不是简单检查err != nil或字符串匹配 - 重试逻辑需重置 context：如果要做超时重试，每次重试都应新建 context，不能复用已 cancel 的 context
进阶：自定义超时策略（如指数退避 + context）
对于高可用服务，可封装一个带重试和动态超时的请求函数：
func doWithRetry(ctx context.Context, url string, maxRetries int) (*http.Response, error) {
var lastErr error
for i := 0; i <= maxRetries; i++ {
// 每次重试生成新超时 context（例如首次 2s，后续每次 +1s）
timeout := time.Duration(2+i) * time.Second
retryCtx, cancel := context.WithTimeout(ctx, timeout)
defer cancel()
req, _ := http.NewRequestWithContext(retryCtx, "GET", url, nil)
resp, err := http.DefaultClient.Do(req)
if err == nil {
return resp, nil
}
lastErr = err
// 若是 context 超时或网络错误，且未达最大重试次数，则继续
if i < maxRetries && (errors.Is(err, context.DeadlineExceeded) || isNetworkError(err)) {
time.Sleep(time.Second * time.Duration(1<}
这种模式兼顾了弹性与可控性，适合对外部 API 的健壮调用。
