Golang HTTP客户端请求错误如何捕获

答案：使用Golang发起HTTP请求时需显式检查error，区分网络错误与HTTP状态码错误，确保资源释放。首先在http.NewRequest和client.Do阶段处理URL格式、网络连接等错误；即使resp非nil也需读取并关闭Body；4xx/5xx状态码不属于error，须手动判断StatusCode；通过类型断言识别*url.Error中的超时或临时错误以支持重试；始终defer resp.Body.Close()防止泄漏；自定义函数应封装错误并向上返回，统一处理。

在使用 Golang 发起 HTTP 客户端请求时，正确捕获和处理错误是确保程序健壮性的关键。Go 的 net/http 包本身不会主动抛出异常，而是通过返回 error 类型来传递问题信息。因此，必须显式检查每次请求的返回值。

检查请求创建和发送阶段的错误

HTTP 请求过程分为多个步骤，每个步骤都可能出错，需要分别处理：

• 构建请求对象：调用 http.NewRequest 时，URL 格式不正确会返回 error。
• 发送请求：调用 client.Do 时，网络不可达、超时、DNS 解析失败等都会导致 error。
• 读取响应体：即使响应状态码是 4xx 或 5xx，resp 可能非 nil，但 Body 仍需读取并关闭。

resp, err := http.Get("https://invalid-url./")
if err != nil {
    log.Printf("请求失败: %v", err)
    return
}
defer resp.Body.Close()

// 注意：404 或 500 等状态码不会触发 err，需手动判断
if resp.StatusCode >= 400 {
    log.Printf("HTTP 错误状态: %d", resp.StatusCode)
}

区分网络错误与业务错误

error 不等于 HTTP 状态错误。比如连接超时、TLS 握手失败属于网络层错误，而 404、500 是服务端返回的业务逻辑错误。

知识画家

AI交互知识生成引擎，一句话生成知识视频、动画和应用

下载

• 网络错误通常为 *url.Error 或 net.OpError 类型，可通过类型断言进一步分析。
• 对于可重试的场景（如超时），可以根据错误类型决定是否重试。

if uerr, ok := err.(*url.Error); ok {
    if uerr.Timeout() {
        log.Println("请求超时")
    } else if uerr.Temporary() {
        log.Println("临时性错误，可尝试重试")
    }
}

确保资源释放与错误传播

即使发生错误，也要注意避免资源泄漏。例如 resp.Body 必须关闭，即使 StatusCode 异常。

立即学习“go语言免费学习笔记（深入）”；

• 始终使用 defer resp.Body.Close()，放在 err 判断之后但尽早声明。
• 自定义函数中应将错误向上返回，便于统一处理或记录日志。

func fetch(url string) ([]byte, error) {
    resp, err := http.Get(url)
    if err != nil {
        return nil, fmt.Errorf("请求失败: %w", err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        return nil, fmt.Errorf("读取响应失败: %w", err)
    }

    if resp.StatusCode != 200 {
        return nil, fmt.Errorf("HTTP 状态错误: %d", resp.StatusCode)
    }

    return body, nil
}