Golang请求错误捕获方法详解

在Go语言网络编程中，健壮的错误处理是保障服务稳定性的核心——必须始终优先检查`error`是否为`nil`，而非直接依赖HTTP状态码，因为连接失败、超时、TLS握手异常等底层问题均通过`error`返回；推荐使用`errors.As()`安全断言`*url.Error`以精准区分超时与普通连接错误，并务必为`http.Client`配置合理的全局及分阶段超时（如拨号、TLS握手、响应头读取），避免请求永久阻塞；只有在`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学习网公众号，给大家分享更多Golang知识！