Golang HTTP库错误处理技巧

正确处理第三方HTTP库错误需先明确库的错误类型，如resty可能返回网络、请求或状态码相关错误；通过类型断言区分网络超时、连接失败等并分类处理；即使err为nil也需检查响应状态码；建议封装原始错误为自定义HttpError类型，统一上层错误处理；结合context.WithTimeout控制超时，仅对幂等操作或可重试错误启用自动重试，并记录重试日志以增强可观测性。

在Go语言开发中，虽然标准库net/http已经足够强大，但在实际项目中，我们常常会使用一些功能更丰富的第三方HTTP库，比如resty、fasthttp（客户端模式）、grequests等。这些库提升了开发效率，但也带来了错误处理的复杂性。正确地捕获和处理第三方HTTP库的错误，是构建健壮服务的关键。

理解第三方库的错误类型

不同的第三方库封装了底层HTTP交互，其返回的错误类型可能与标准库不同。以resty为例，它的请求方法通常返回*resty.Response, error，其中error可能是：

• 网络层错误（如连接超时、DNS解析失败）
• 请求构建错误（如无效URL、序列化失败）
• 响应状态码非2xx或3xx时是否视为错误（可配置）

因此，在处理错误前，先要明确你使用的库在哪些情况下会返回error != nil。

结构化错误判断与类型断言

为了精准处理错误，应避免只用if err != nil就统一上报。可通过类型断言或错误信息内容进行分类处理。

以resty为例：

resp, err := client.R().Get("https://api.example.com/data")
if err != nil {
    // 判断是否为网络错误
    if netErr, ok := err.(net.Error); ok {
        if netErr.Timeout() {
            log.Println("请求超时:", netErr)
        } else {
            log.Println("网络连接错误:", netErr)
        }
        return
    }

    // 其他通用错误
    log.Printf("请求失败: %v", err)
    return
}

// 即使err为nil，也可能返回4xx/5xx状态码
if !resp.IsSuccess() {
    log.Printf("HTTP %d: %s", resp.StatusCode(), resp.Status())
}

对于fasthttp客户端，其Do方法返回的错误多为底层网络问题，需结合返回码进一步判断语义错误。

统一错误封装提升可维护性

在项目中建议将第三方库的错误封装成自定义错误类型，便于上层逻辑统一处理。

例如定义：

type HttpError struct {
    Message string
    Code    int      // HTTP状态码
    RawErr  error    // 原始错误
    Url     string
}

func (e *HttpError) Error() string {
    return fmt.Sprintf("HTTP请求失败 [%s] %d: %s", e.Url, e.Code, e.Message)
}

在调用第三方库后转换错误：

resp, err := restyClient.R().SetResult(&result).Post(url)
if err != nil {
    return nil, &HttpError{
        Message: err.Error(),
        Code:    resp.StatusCode(),
        RawErr:  err,
        Url:     url,
    }
}
if !resp.IsSuccess() {
    return nil, &HttpError{
        Message: "received non-success status",
        Code:    resp.StatusCode(),
        Url:     url,
    }
}

这样上层可以统一通过errors.As提取并处理特定错误类型。

重试机制与上下文超时配合

很多第三方库支持自动重试（如resty的SetRetryCount），但需注意：

• 仅对幂等操作（GET）或明确可重试的错误（5xx、网络超时）启用重试
• 结合context.WithTimeout防止整体耗时过长
• 记录重试日志以便排查问题

示例：

ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
defer cancel()

resp, err := client.R().
    SetContext(ctx).
    Get("https://httpbin.org/delay/3")

当context超时时，错误会被自动捕获，无需手动判断时间。

基本上就这些。关键是根据所用库的行为特点，分层处理网络错误、协议错误和业务错误，避免“一错到底”。同时通过封装和上下文控制，让HTTP调用更可控、可观测。