Go语言HTTP客户端：无网络时快速超时配置方案

要实现无网络时立即返回错误、有网络时保持20秒请求超时的需求，核心是拆分连接阶段与整体请求的超时控制：默认的http.Client.Timeout是全局超时，覆盖从拨号到响应读取的全流程，而无网络时的延迟主要卡在TCP拨号阶段，因此需要单独缩短拨号阶段的超时，同时保留全局20秒的请求超时。

具体实现步骤 #

• 自定义http.Transport，通过DialContext设置短时间的拨号超时（比如1秒），用于快速检测无网络场景；
• 保持http.Client的全局Timeout为20秒，确保有网络但请求缓慢时能等待足够时长。

示例代码 #

package main

import (
    "context"
    "net"
    "net/http"
    "time"
)

func main() {
    // 自定义Transport，设置拨号超时
    transport := &http.Transport{
        DialContext: func(ctx context.Context, network, addr string) (net.Conn, error) {
            // 创建带1秒超时的context用于拨号，快速检测无网络
            dialCtx, cancel := context.WithTimeout(ctx, time.Second*1)
            defer cancel()
            return net.DialContext(dialCtx, network, addr)
        },
        // 可根据需求添加其他Transport配置（如TLS参数、连接池等）
    }

    // 配置客户端：全局超时20秒，使用自定义Transport
    client := &http.Client{
        Timeout:   time.Second * 20,
        Transport: transport,
    }

    // 发起请求
    url := "https://example.com"
    response, err := client.Get(url)
    if err != nil {
        // 无网络时1秒内返回错误；有网络但请求缓慢时，等待至20秒超时
        panic(err)
    }
    defer response.Body.Close()
    // 后续响应处理逻辑...
}

原理说明 #

• 拨号阶段短超时：无网络时，TCP拨号会在1秒内失败，直接返回错误，避免等待全局20秒；
• 全局请求长超时：拨号成功（说明有网络）后，DNS解析、请求发送、响应读取等后续流程受20秒全局超时控制，确保慢请求能等待足够时长再返回错误。

针对iOS模拟器（gomobile）的补充优化 #

如果需要更精准的系统网络状态检测（比如识别飞行模式、网络权限禁用），可以通过gomobile绑定iOS系统的NetworkReachability API：

1. 编写Objective-C/Swift代码实现网络状态检测逻辑；
2. 通过cgo将检测方法暴露给Go代码；
3. 在发起HTTP请求前先调用检测方法，无网络时直接返回错误，无需进入请求流程。

这种方式能实现真正的“立即返回”，但依赖平台特定代码，适合对响应速度要求极高的场景。

内容的提问来源于stack exchange，提问作者scosman