Содержание
  1. Проблема отказавшей зависимости
  2. Три состояния
  3. Окно и порог
  4. Учебный журнал вызовов
  5. Retry и fallback
  6. Восстановление и наблюдение
  7. Когда нужен bulkhead
  8. Частые вопросы
Справочник

Что такое circuit breaker и когда остановить запросы

15 ноября 2026 · 10 минут чтения

Circuit breaker — это программный шаблон, который прекращает обращения к отказавшей зависимости на время, пока она не восстановится. Что такое circuit breaker и когда остановить запросы: при достижении порога ошибок вызовы отклоняются локально, без сетевого запроса, а через заданный интервал допускаются пробы согласно политике реализации.

Проблема отказавшей зависимости

Отказ внешнего сервиса опасен тем, что вызывающий код продолжает тратить ресурсы на обращения, которые не могут завершиться успехом. В документации AWS Prescriptive Guidance описана ситуация, когда превышение таймаутов над заданным порогом приводит к размыканию цепи: приложение открывает circuit. Пока этого не произошло, каждый новый вызов занимает поток, соединение и место в очереди.

В статье Мартина Фаулера на martinfowler.com сформулирован ключевой эффект: когда отказы достигают определённого порога, breaker срабатывает, и все дальнейшие вызовы возвращают ошибку, при этом защищённый вызов вообще не выполняется. Это экономит время ожидания и освобождает ресурсы вызывающей стороны.

Проблема усугубляется тем, что отказ зависимости редко бывает мгновенным. Сервис может отвечать медленно, удерживая соединения до истечения таймаута. Без ограничения параллелизма и таймаута накапливаются зависшие вызовы, и вызывающее приложение деградирует вместе с зависимостью. Circuit breaker решает часть задачи: он прекращает поток новых обращений после того, как статистика показала устойчивый отказ. Оставшуюся часть закрывают таймауты и лимит одновременных вызовов.

Отдельно стоит различать типы ошибок. В статье Фаулера отмечено, что не все ошибки должны размыкать цепь: часть отражает нормальные сбои и обрабатывается обычной логикой. Ошибка валидации входных данных означает проблему в запросе, и её обработка относится к прикладному коду. Размыкание цепи имеет смысл для отказов, связанных с доступностью и работоспособностью зависимости.

Практический признак проблемы: рост времени ответа и доли ошибок при неизменной нагрузке. В этот момент полезно посмотреть на статистику вызовов и решить, настроен ли уже порог, при котором обращения прекращаются. Если порог не задан, приложение продолжает давить на неисправный сервис, усугубляя его состояние.

Три состояния

В документации Resilience4j описана реализация через конечный автомат с тремя нормальными состояниями: CLOSED, OPEN и HALF_OPEN, а также специальными состояниями METRICS_ONLY, DISABLED и FORCED_OPEN. Нормальные состояния описывают рабочий цикл, специальные — режимы эксплуатации и отладки.

CLOSED — рабочее состояние. Вызовы проходят к зависимости, а результат каждого фиксируется в статистике. Пока доля ошибок ниже порога, цепь остаётся замкнутой. Это состояние по умолчанию для исправной зависимости.

OPEN — состояние размыкания. Вызовы отклоняются локально, сетевой запрос не отправляется. В статье Фаулера описано, что при этом все обращения возвращают ошибку без выполнения защищённого вызова. Состояние держится заданный интервал, после чего наступает следующий этап.

HALF_OPEN — состояние проверки. В статье Фаулера оно описано как готовность сделать реальный вызов в качестве пробы. Число допускаемых проб зависит от реализации; в нашем примере проба одна. Успешная проба возвращает цепь в CLOSED, неуспешная — снова в OPEN.

Переходы между состояниями управляются статистикой и таймером. В документации AWS Prescriptive Guidance указано, что объект breaker периодически проверяет, успешны ли обращения к сервису. Там же отмечено требование: реализация должна следить за тем, чтобы последующие вызовы не сдвигали срок истечения таймаута бесконечно. Иначе постоянные попытки будут продлевать открытое состояние и восстановление не наступит.

Специальные состояния служат для управления поведением. METRICS_ONLY собирает статистику без размыкания, DISABLED отключает breaker, FORCED_OPEN принудительно держит цепь разомкнутой. Эти режимы полезны при отладке и при постепенном включении защиты.

Состояние Поведение вызова Условие перехода
CLOSED Вызов идёт к зависимости Доля ошибок достигла порога → OPEN
OPEN Вызов отклоняется локально Истёк интервал → HALF_OPEN
HALF_OPEN Ограниченное политикой число проб Результаты проб → CLOSED или OPEN

Окно и порог

Порог ошибок рассчитывается по скользящему окну завершённых вызовов. В документации Resilience4j указано, что доля ошибок и доля медленных вызовов вычисляются только при условии, что записано минимальное число вызовов. Это защищает от преждевременного размыкания: одна ошибка при малом числе обращений не должна останавливать работу.

Учебная политика для примера задаёт окно в 4 завершённых вызова, минимум 4 вызова, порог ошибок 50% и длительность открытого состояния 30 секунд. Эти значения выбраны для наглядности и не являются настройками по умолчанию какой-либо библиотеки. Последовательность success, error, error, success даёт 2 ошибки из 4, то есть 50%, и цепь размыкается.

Скользящее окно считает завершённые вызовы и не ограничивает параллелизм. В документации Resilience4j прямо отмечено, что скользящее окно не означает разрешение только 15 одновременных вызовов. Пока порог не достигнут, одновременно могут висеть многие медленные вызовы. Для ограничения параллелизма нужны таймаут и лимит одновременных обращений.

Выбор порога зависит от характера зависимости. Для сервиса с редкими вызовами высокий минимум вызовов означает, что breaker сработает поздно. Для сервиса с высокой частотой обращений низкий порог приведёт к частым размыканиям на случайных колебаниях. Окно задаёт период, за который оценивается статистика, а минимум вызовов — порог доверия к этой оценке.

Длительность открытого состояния определяет, как долго приложение обходится без зависимости. Слишком короткий интервал приводит к постоянным пробам и нагрузке на неисправный сервис. Слишком длинный задерживает возврат к нормальной работе после быстрого восстановления. В документации AWS Prescriptive Guidance отмечено требование не продлевать срок истечения при каждом последующем вызове.

Учебный журнал вызовов

Журнал фиксирует четыре поля: время, состояние, отправлен ли запрос, результат. Такая запись позволяет восстановить хронологию и проверить, что размыкание соответствует заданной статистической политике. Ниже — учебный журнал для политики с окном 4 вызова, минимумом 4, порогом 50% и открытым состоянием 30 секунд.

ТЕКСТ8 строк
ts      state       request_sent  outcome
вызов_A   CLOSED      yes           success
вызов_B   CLOSED      yes           error
вызов_C   CLOSED      yes           error
t_open   CLOSED      yes           success   -> 2/4 = 50%, порог достигнут
t_open   OPEN        no            rejected  -> цепь разомкнута
t_open+10с   OPEN        no            rejected  -> вызов отклонён локально
t_open+30с   HALF_OPEN   yes           success   -> возврат в CLOSED

Четвёртая запись закрывает окно: две ошибки из четырёх дают 50%, и breaker открывается. Следующий вызов через 10 секунд отклоняется локально, сетевой запрос не отправляется. Через 30 секунд допускается одна проба. Успешная проба возвращает цепь в CLOSED, неуспешная — в OPEN.

Журнал показывает, что поле request_sent отличает реальные обращения от локальных отказов. Это главный признак работающего breaker: в открытом состоянии сетевой запрос отсутствует. Если в журнале при состоянии OPEN стоит request_sent=yes, защита не срабатывает и вызовы продолжают уходить к зависимости.

Проверка результата строится на сверке журнала с ожидаемой политикой. Считается доля ошибок в окне, сравнивается с порогом, проверяется момент перехода в OPEN и длительность открытого состояния. Расхождение указывает на неверную настройку окна, минимума вызовов или таймера.

Retry и fallback

Retry и circuit breaker решают разные задачи. В документации Microsoft Learn по реализации шаблона отмечено, что у circuit breaker другое назначение, чем у retry pattern. Retry повторяет временно неудачный вызов, breaker прекращает обращения к зависимости, которая устойчиво не работает.

Сочетание требует согласования. В документации Microsoft Learn указано, что логика повторных попыток должна учитывать исключение, возвращаемое breaker, и прекращать повторы, когда тот сообщает, что сбой не является временным. Иначе повторы будут биться в разомкнутую цепь и создавать нагрузку. Там же отмечен риск экспоненциального роста трафика к отказавшему сервису при неограниченных повторах.

Для сочетания retry на уровне SDK и внешнего retry устанавливают общую верхнюю границу попыток. Без неё вложенные повторы перемножаются и дают кратное число обращений. Общая граница задаёт предел, выше которого вызов завершается ошибкой.

Fallback даёт альтернативный ответ, когда вызов отклонён. В документации Resilience4j описан приём восстановления из исключения до того, как breaker запишет его как отказ. Fallback из кэша помечается как возможно устаревший: он не доказывает успех внешнего действия. Если операция меняла состояние зависимости, ответ из кэша не подтверждает выполнение этой операции.

Для схемы, в которой отказ зависимости должен попасть в метрики, сначала проверяют состояние цепи, выполняют вызов с таймаутом, фиксируют результат и затем применяют fallback. Восстановление внутри защищённого вызова, до записи ошибки, меняет статистику: Resilience4j описывает оба варианта, поэтому порядок выбирают явно.

Восстановление и наблюдение

Восстановление начинается с пробной попытки в состоянии HALF_OPEN. В документации AWS Prescriptive Guidance описано периодическое обращение breaker к сервису для проверки успешности вызовов. Учебная политика допускает одну пробу: успех возвращает цепь в CLOSED, ошибка — в OPEN.

Таймер перехода из OPEN в HALF_OPEN может требовать явного включения. В документации Resilience4j отмечено, что автоматический переход по умолчанию выключен. При выключенном автоматическом переходе Resilience4j может перейти к пробе при следующем вызове после истечения ожидания. Это отличается от фонового перехода по таймеру; конкретную конфигурацию проверяют в документации.

Сброс состояния доступен как отдельная операция. В документации Resilience4j указано, что breaker поддерживает возврат к исходному состоянию с потерей всех метрик и сбросом скользящего окна. Такой сброс применяют после устранения причины отказа, когда накопленная статистика устарела.

Наблюдение строится на метриках состояний и переходов. Полезно отслеживать долю ошибок в окне, число локальных отказов, длительность пребывания в OPEN и результат проб. Рост локальных отказов при неизменной нагрузке указывает на размыкание цепи. Частые переходы между состояниями говорят о нестабильной зависимости или о слишком чувствительном пороге.

Проверка конфигурации включает сверку окна, минимума вызовов, порога и таймера с документацией реализации. Состояния и окна конкретной библиотеки проверяются по её документации, поскольку имена и значения параметров различаются.

Когда нужен bulkhead

Bulkhead ограничивает число одновременных вызовов к зависимости. Это отдельный шаблон, который решает задачу, не покрываемую circuit breaker. В документации Resilience4j отмечено, что скользящее окно не ограничивает параллелизм. Пока порог ошибок не достигнут, множество медленных вызовов может удерживать ресурсы одновременно.

Bulkhead нужен, когда зависимость отвечает медленно, но формально успешно. Доля ошибок остаётся низкой, цепь не размыкается, а потоки и соединения расходуются на ожидание. Лимит одновременных вызовов отсекает лишние обращения и сохраняет ресурсы для других операций.

Совместная настройка включает таймаут, лимит параллелизма и порог ошибок. Таймаут ограничивает время ожидания одного вызова, лимит — число одновременных обращений, порог — долю ошибок, при которой цепь размыкается. Эти параметры дополняют друг друга и настраиваются по отдельности.

Признак необходимости bulkhead: рост времени ответа без роста доли ошибок. Если breaker не учитывает медленные ответы как основание для размыкания, он может остаться в CLOSED, пока приложение накапливает ожидающие вызовы. Лимит параллелизма и таймаут закрывают этот сценарий.

Частые вопросы

Что такое circuit breaker pattern простыми словами?
Это защита, которая прекращает обращения к неисправной зависимости на время. При достижении порога ошибок вызовы отклоняются локально, без сетевого запроса. После интервала ожидания допускаются пробные вызовы по политике реализации; в учебном примере проба одна.

Чем circuit breaker отличается от retry?
Retry повторяет временно неудачный вызов, breaker прекращает обращения к зависимости с устойчивым отказом. В документации Microsoft Learn отмечено разное назначение этих шаблонов. Логика повторов должна прекращать попытки, когда breaker сообщает о нетранзиентном сбое.

Как настроить окно и порог ошибок?
Окно задаёт выборку завершённых вызовов: по их числу или по времени. Минимум вызовов определяет, достаточно ли данных для расчёта, доля ошибок — условие размыкания. В документации Resilience4j предусмотрены оба типа окна. Конкретные значения подбираются под нагрузку и поведение зависимости.

Что происходит в состоянии half-open?
Допускается ограниченное политикой число проб. В учебном примере проба одна: успех возвращает цепь в CLOSED, ошибка — в OPEN. В Resilience4j фоновый переход по таймеру требует включения; без него переход возможен при следующем вызове после ожидания.

Когда нужен bulkhead вместо circuit breaker?
Bulkhead ограничивает число одновременных вызовов и нужен при медленных, но формально успешных ответах. Скользящее окно breaker не ограничивает параллелизм. Таймаут, лимит параллелизма и порог ошибок настраиваются совместно.

Читайте также

3 материала