Параллельная обработка набора задач в Go (веерные HTTP-запросы, выгрузка батчей или этапы пайплайна) часто требует шаблонного кода: связки sync.WaitGroup, буферизованных каналов ошибок, ручного context.CancelFunc и семафоров.
Пакет golang.org/x/sync/errgroup объединяет управление жизненным циклом горутин, отмену контекста и возврат ошибок в единую конструкцию.
По официальной документации пакета, типовой сценарий строится по шагам:
- Инициализация:
g, ctx := errgroup.WithContext(parentCtx)создает группу и контекст, отменяемый при первой ошибке любой горутины либо по вызовуWait. - Ограничение пула: вызов
g.SetLimit(n)задает лимит одновременно работающих горутин без сторонних семафоров. - Запуск воркеров: подзадачи передаются через
g.Go(func() error { return work(ctx) }). Для неблокирующего запуска доступен методg.TryGo. - Синхронизация:
err := g.Wait()ожидает завершения всех горутин и возвращает первую возникшую ошибкуnon-nil.
Нюансы: SetLimit нельзя менять при активных горутинах. Воркеры обязаны проверять ctx.Done(), так как отмена контекста не прерывает чужой код автоматически. Экземпляр Group не переиспользуется повторно после вызова Wait.
