Когда бэкенд на Go выполняет цепочку однотипных SQL-операций, первое инстинктивное желание — собрать их в пакет и отправить за один сетевой раунд-трип. Драйвер pgx от Джека Кристенсена (Jack Christensen) предоставляет для этого отличный инструмент — структуру pgx.Batch. Вместо последовательных сетевых вызовов запросы улетают в PostgreSQL пачкой, экономя драгоценные миллисекунды сетевой задержки.
Но если ты переходишь на pgx со стандартного пакета database/sql, тебя ждет неприятный сюрприз: соединение из пула неожиданно оказывается заблокированным со статусом conn busy, а в логах начинают всплывать непонятные ошибки о деаллокации подготовленных стейтментов. Мы уже разбирали поведение очереди пула соединений в Go, но в pgx у пакетных запросов есть собственная строгая специфика.
Давай разберем, как устроен жизненный цикл пакета «под капотом» и почему стандартный вызов defer br.Close() здесь таит в себе скрытую ловушку.
Ловушка занятого соединения: почему defer br.Close() не так прост
После вызова pool.SendBatch(ctx, batch) драйвер берет физическое TCP-соединение и переводит его в состояние монопольной занятости. Интерфейс BatchResults начинает последовательно получать результаты. И вот тут кроется главная деталь: даже если ты прочитал нужные данные из первого SELECT через br.QueryRow().Scan(...), соединение нельзя использовать ни для каких других операций до тех пор, пока не будет вызван метод br.Close().
В Go принято освобождать ресурсы отложенным вызовом defer resource.Close(). Но у BatchResults.Close() есть принципиальное отличие: он возвращает error.
// Так делать опасно: ошибка вычитки сокета будет потеряна
br := pool.SendBatch(ctx, batch)
defer br.Close()
Метод Close() не просто закрывает сетевой дескриптор. Он последовательно дочитывает из буфера сокета все оставшиеся байты ответов сервера PostgreSQL для всех запросов пакета. Если третий запрос из пяти упал с ошибкой внешнего ключа (foreign key violation) или синтаксической ошибкой, именно метод Close() прочитает это сообщение от базы и вернет ошибку наружу.
Если ты напишешь обычный defer br.Close(), твоя функция посчитает операцию успешной, хотя в базе данных произошел сбой, а неявная транзакция (implicit transaction) пакета откатилась назад.
Идиоматичный паттерн: именованный возврат и безопасная вычитка
Чтобы не потерять ошибку завершения и гарантированно вернуть соединение в pgxpool.Pool, в Go используется идиоматичный паттерн с именованным возвращаемым значением ошибки:
package repository
import (
"context"
"fmt"
"github.com/jackc/pgx/v5"
"github.com/jackc/pgx/v5/pgxpool"
)
type AccountCredit struct {
AccountID int64
Amount int64
}
func ProcessCreditsBatch(ctx context.Context, pool *pgxpool.Pool, items []AccountCredit) (err error) {
batch := &pgx.Batch{}
for _, item := range items {
batch.Queue(
"UPDATE accounts SET balance = balance + $1, updated_at = NOW() WHERE id = $2",
item.Amount,
item.AccountID,
)
}
br := pool.SendBatch(ctx, batch)
// Захватываем ошибку закрытия пакета через именованную переменную err
defer func() {
if closeErr := br.Close(); closeErr != nil && err == nil {
err = fmt.Errorf("ошибка закрытия pgx batch: %w", closeErr)
}
}()
for i := 0; i < len(items); i++ {
cmdTag, execErr := br.Exec()
if execErr != nil {
return fmt.Errorf("сбой запроса %d в пакете: %w", i, execErr)
}
if cmdTag.RowsAffected() == 0 {
return fmt.Errorf("аккаунт %d не найден", items[i].AccountID)
}
}
return nil
}
Такая конструкция дает двойную гарантию. Во-первых, соединение гарантированно вернется в пул даже в случае паники или досрочного выхода. Во-вторых, если база упадет на этапе финализации сокета, ошибка не растворится в воздухе, а корректно всплывет на уровень бизнес-логики.



