x/sync/semaphore и отмена

Acquire с контекстом

sem := semaphore.NewWeighted(8)

if err := sem.Acquire(ctx, 1); err != nil {
    return err // отменены, пока ждали
}
defer sem.Release(1)

recognize(ctx, f)

Канал-семафор из умел только блокироваться. У пакетного семафора Acquire принимает контекст: если ctx отменён, пока горутина ждёт разрешения, Acquire возвращает ошибку и не занимает разрешение. Это главное отличие: с каналом горутина могла бы занять токен в момент отмены и утечь вместе с ним.

Где это важно

Сценарий: горутина ждёт свободный слот на вызов внешнего API распознавания, а запрос тем временем отменяют (клиент закрыл вкладку). С каналом-семафором она так и будет висеть в очереди (или займёт токен и зависнет дальше). С Acquire(ctx, 1) — выйдет сразу с ошибкой context.Canceled. Для сервисов, где отмена — норма жизни, это не мелочь, а защита от копящихся «ждунов».

Пара Acquire/Release

if err := sem.Acquire(ctx, 1); err != nil {
    return err
}
defer sem.Release(1)

Симметрия: успешный Acquire — и тут же defer Release. Возврат случится при любом выходе из функции, и про парность можно не думать. Успех Acquire — единственная точка, где разрешение занято, поэтому утечка разрешений возможна только при явной ошибке в коде.