Golang请求错误捕获方法详解

本篇文章向大家介绍《Golang网络请求错误捕获技巧》，主要包括，具有一定的参考价值，需要的朋友可以参考一下。

正确处理Golang网络请求错误需先判断error是否为nil，再检查状态码。常见错误包括连接失败、超时、TLS握手失败等，均通过error返回而非HTTP状态码。应使用errors.As()对*url.Error进行类型断言，区分超时与普通连接错误，并设置合理超时避免阻塞。只有err为nil时才可安全读取响应体并校验状态码，确保程序健壮性。

在 Golang 中进行网络请求时，错误处理是保证程序健壮性的关键环节。很多开发者初上手时常忽略或误判错误类型，导致程序在遇到网络异常、超时或服务不可达时崩溃或行为不可控。正确捕获和处理这些错误，不仅能提升稳定性，还能为后续排查问题提供依据。

理解 net/http 中的常见错误类型

使用 net/http 包发起请求时，错误通常来自 http.Client.Do() 方法返回的第二个参数 error。这个 error 可能包含多种底层问题：

• 连接失败：目标主机无法访问、DNS 解析失败
• 超时：请求耗时超过设定时限
• TLS 握手失败：证书问题、不支持的协议版本
• 空响应：服务器未返回有效 response（resp 为 nil）

这些错误不会以 HTTP 状态码形式出现（如 404、500），而是直接通过 error 返回。因此不能只检查 status code，必须先判断 error 是否为 nil。

正确捕获并分类处理错误

实际开发中应根据错误类型采取不同策略，例如重试、记录日志或向上抛出。可以通过类型断言判断是否为 *url.Error，它封装了底层错误详情：

resp, err := http.Get("https://httpbin.org/delay/5")
if err != nil {
    var urlErr *url.Error
    if errors.As(err, &urlErr) {
        if urlErr.Timeout() {
            log.Println("请求超时:", urlErr)
        } else {
            log.Println("连接错误:", urlErr.Err)
        }
    } else {
        log.Println("未知错误:", err)
    }
    return
}
defer resp.Body.Close()

这里用 errors.As() 替代旧式类型断言，更安全且兼容包装错误。如果知道具体场景，还可以进一步判断是否为 DNS 错误或 TLS 错误。

设置合理的超时避免永久阻塞

默认的 http.Client 没有超时设置，可能导致请求长时间挂起。生产环境务必配置超时：

client := &http.Client{
    Timeout: 10 * time.Second,
}
resp, err := client.Get("https://example.com")

也可以精细控制各阶段超时：

client := &http.Client{
    Transport: &http.Transport{
        DialContext: (&net.Dialer{
            Timeout:   5 * time.Second,
            KeepAlive: 30 * time.Second,
        }).DialContext,
        TLSHandshakeTimeout:   5 * time.Second,
        ResponseHeaderTimeout: 10 * time.Second,
        ExpectContinueTimeout: 1 * time.Second,
    },
    Timeout: 30 * time.Second,
}

这样可以更精准地识别是连接阶段还是读取阶段出错。

结合状态码与网络错误综合判断

即使请求成功（err == nil），也可能返回非 2xx 状态码。需同时检查：

if resp.StatusCode >= 400 {
    body, _ := io.ReadAll(resp.Body)
    log.Printf("业务错误 %d: %s", resp.StatusCode, string(body))
}

注意：只有在网络层无错误的前提下才能读取 Body。否则 resp 可能为 nil，直接调用会 panic。

基本上就这些。Golang 的错误处理虽显繁琐，但清晰明确。只要养成“先判 error，再读响应”的习惯，并合理设置超时，就能有效应对大多数网络异常。

今天关于《Golang请求错误捕获方法详解》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！