HTTP-клиент для Go (Golang): топ библиотек

HTTP-клиент для Go (Golang): топ библиотек для эффективной работы с сетью

Go (Golang) славится своей производительностью и встроенной поддержкой сетевого взаимодействия. Стандартный пакет net/http предоставляет мощный HTTP-клиент, однако в сложных проектах часто требуются дополнительные возможности: автоматические ретраи, пулы соединений, гибкая обработка ошибок и удобный fluent-интерфейс. В этой статье мы рассмотрим лучшие библиотеки для создания HTTP-клиентов в Go, сравним их особенности и приведём практические примеры.

1. Стандартный пакет net/http

Встроенный клиент net/http — основа для большинства Go-приложений. Он полностью покрывает базовые потребности: GET/POST запросы, работа с заголовками, куками и таймаутами. Однако для продвинутого использования требуется ручная настройка.

package main

import (
    "fmt"
    "io"
    "net/http"
    "time"
)

func main() {
    client := &http.Client{
        Timeout: 10 * time.Second,
        Transport: &http.Transport{
            MaxIdleConns:        100,
            MaxIdleConnsPerHost: 20,
            IdleConnTimeout:     60 * time.Second,
        },
    }

    resp, err := client.Get("https://api.example.com/data")
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

Плюсы: нулевые зависимости, полный контроль, встроенная поддержка HTTP/2. Минусы: отсутствие автоматических ретраев и удобных методов для работы с JSON.

2. Resty — элегантный HTTP-клиент для Go

Resty (github.com/go-resty/resty/v2) — одна из самых популярных библиотек. Она предлагает fluent-интерфейс, автоматическую сериализацию/десериализацию JSON, встроенные ретраи и middleware.

package main

import (
    "fmt"
    "github.com/go-resty/resty/v2"
)

type User struct {
    ID   int    `json:"id"`
    Name string `json:"name"`
}

func main() {
    client := resty.New()
    client.SetRetryCount(3).SetRetryWaitTime(2)

    var user User
    resp, err := client.R().
        SetHeader("Accept", "application/json").
        SetResult(&user).
        Get("https://jsonplaceholder.typicode.com/users/1")

    if err != nil {
        panic(err)
    }

    fmt.Printf("Status: %d, User: %+v\n", resp.StatusCode(), user)
}

Resty поддерживает: автоматическое повторение запросов (с экспоненциальной задержкой), цепочки вызовов, встроенный логгер, работу с multipart/form-data. Отлично подходит для REST API.

3. FastHTTP — максимальная производительность

Библиотека github.com/valyala/fasthttp создана для сценариев с экстремальными требованиями к скорости. Она перерабатывает HTTP-протокол с нуля, используя пулы объектов и избегая аллокаций. FastHTTP может быть в 5-10 раз быстрее стандартного клиента.

package main

import (
    "fmt"
    "github.com/valyala/fasthttp"
)

func main() {
    url := "https://httpbin.org/get"
    statusCode, body, err := fasthttp.Get(nil, url)
    if err != nil {
        panic(err)
    }

    fmt.Printf("Status: %d\n", statusCode)
    fmt.Printf("Body: %s\n", body)
}

Важно: FastHTTP не поддерживает HTTP/2 и имеет несколько отличный API. Используйте его для высоконагруженных микросервисов, где важна каждая микросекунда.

4. Gentee HTTP — гибкость и модульность

Gentee (github.com/gentee/gentee) — менее известная, но интересная библиотека, предоставляющая модульный подход. Она позволяет комбинировать различные транспорты, кодеки и обработчики ошибок.

package main

import (
    "context"
    "fmt"
    "github.com/gentee/gentee/http"
)

func main() {
    client := http.NewClient()
    req := http.NewRequest("GET", "https://api.example.com").
        WithHeader("Authorization", "Bearer token")

    resp, err := client.Do(context.Background(), req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    fmt.Println(resp.Status)
}

Gentee поддерживает middleware-цепи, легко расширяется и подходит для проектов с нестандартными требованиями.