最推荐方式是结合 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 泄漏 <p>req, err := http.NewRequestWithContext(ctx, "GET", "<a href="https://www.php.cn/link/46b315dd44d174daf5617e22b3ac94ca">https://www.php.cn/link/46b315dd44d174daf5617e22b3ac94ca</a>", nil) if err != nil { log.Fatal(err) }</p><p>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, } <p>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() <pre class="brush:php;toolbar:false;"> 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<<i)) // 指数退避 continue } break } return nil, lastErr}
这种模式兼顾了弹性与可控性，适合对外部 API 的健壮调用。