Golang httpClient 请求时常遇到 EOF 错误的解决方法

在使用 Go 的 http.Client 进行 HTTP 请求时，偶尔会遇到 EOF 错误。这个错误通常与网络连接问题或 HTTP 客户端的使用方式不当有关。以下是一些常见原因和解决方法。

常见原因

连接被意外关闭：EOF 错误表示 "End Of File"，在 HTTP 请求中通常是指连接被提前关闭，可能是服务端关闭了连接，或者客户端的连接管理不当导致的。
HTTP 连接复用问题：Go 的 HTTP 客户端默认使用连接复用，多个请求可能会共享同一个 TCP 连接。当一个连接被错误关闭后，客户端再使用它时就会产生 EOF 错误。
未设置读写超时：如果没有设置超时，连接可能在长时间未响应时被关闭，导致 EOF 错误。
服务端返回不完整的响应：服务端由于内部问题返回了不完整的响应，客户端尝试读取时读取不到完整数据，进而出现 EOF 错误。
并发请求中使用已关闭的响应体：在并发情况下，如果没有正确关闭上一个请求的 Body，可能导致连接被关闭，后续请求使用该连接时产生 EOF 错误。

如何解决 EOF 问题

1. 确保关闭 `response.Body`

每次请求后，确保正确关闭 response.Body 以避免连接泄漏和连接池问题。

resp, err := http.Get("http://example.com")
if err != nil {
    log.Fatalf("HTTP request failed: %v", err)
}
defer resp.Body.Close()

body, err := io.ReadAll(resp.Body)
if err != nil {
    log.Fatalf("Reading response body failed: %v", err)
}
fmt.Println(string(body))

2. 设置超时

设置合理的请求超时时间，避免因网络问题或服务器延迟导致的等待。

client := &http.Client{
    Timeout: 10 * time.Second, // 请求超时
}

如果要分别控制 TCP 连接、读、写的超时，可以使用 http.Transport：

transport := &http.Transport{
    DialContext: (&net.Dialer{
        Timeout:   5 * time.Second,
        KeepAlive: 30 * time.Second,
    }).DialContext,
    TLSHandshakeTimeout:   5 * time.Second,
    ResponseHeaderTimeout: 10 * time.Second,
    IdleConnTimeout:       90 * time.Second,
}

client := &http.Client{
    Transport: transport,
}

3. 避免过度复用连接

禁用连接复用来排查长时间应用中的连接状态问题，虽然可能影响性能，但可以帮助避免 EOF 错误。

transport := &http.Transport{
    DisableKeepAlives: true, // 禁用 Keep-Alive
}

client := &http.Client{
    Transport: transport,
}

4. 增加重试逻辑

加入重试机制以增强程序的鲁棒性，处理偶发的网络波动。

func doRequestWithRetry(url string, retries int) ([]byte, error) {
    client := &http.Client{Timeout: 10 * time.Second}

    for i := 0; i < retries; i++ {
        resp, err := client.Get(url)
        if err == nil {
            defer resp.Body.Close()
            body, err := io.ReadAll(resp.Body)
            if err != nil {
                return nil, fmt.Errorf("failed to read response body: %w", err)
            }
            return body, nil
        }
        log.Printf("Request failed: %v. Retrying (%d/%d)...", err, i+1, retries)
        time.Sleep(2 * time.Second)
    }
    return nil, fmt.Errorf("request failed after %d retries", retries)
}