errgroup в Go: параллельное выполнение подзадач с лимитом и отменой по ошибкеКратко · дайджест за 23 августа
Кратко≈ 1 мин

errgroup в Go: параллельное выполнение подзадач с лимитом и отменой по ошибке

Параллельная обработка набора задач в Go (веерные HTTP-запросы, выгрузка батчей или этапы пайплайна) часто требует шаблонного кода: связки sync.WaitGroup, буферизованных каналов ошибок, ручного context.CancelFunc и семафоров.

Пакет golang.org/x/sync/errgroup объединяет управление жизненным циклом горутин, отмену контекста и возврат ошибок в единую конструкцию.

По официальной документации пакета, типовой сценарий строится по шагам:

  1. Инициализация: g, ctx := errgroup.WithContext(parentCtx) создает группу и контекст, отменяемый при первой ошибке любой горутины либо по вызову Wait.
  2. Ограничение пула: вызов g.SetLimit(n) задает лимит одновременно работающих горутин без сторонних семафоров.
  3. Запуск воркеров: подзадачи передаются через g.Go(func() error { return work(ctx) }). Для неблокирующего запуска доступен метод g.TryGo.
  4. Синхронизация: err := g.Wait() ожидает завершения всех горутин и возвращает первую возникшую ошибку non-nil.

Нюансы: SetLimit нельзя менять при активных горутинах. Воркеры обязаны проверять ctx.Done(), так как отмена контекста не прерывает чужой код автоматически. Экземпляр Group не переиспользуется повторно после вызова Wait.

Хочу подробный разборГолоса помогают выбрать, что разобрать подробно. За этот материал 0 голосов.
Источники · 2