Как подключить circuit breaker к вызову внешнего сервиса в Spring Boot?

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

Подключение: resilience4j-spring-boot3 (или spring-cloud-starter-circuitbreaker-resilience4j) и spring-boot-starter-aop.

@CircuitBreaker(name = "payments", fallbackMethod = "pendingPayment")
public PaymentStatus charge(Order o) { return client.charge(o); }

PaymentStatus pendingPayment(Order o, Throwable e) {
    return PaymentStatus.PENDING;          // принять заказ, оплату проверить позже
}

resilience4j.circuitbreaker.instances.payments:
  sliding-window-size: 50
  minimum-number-of-calls: 20
  failure-rate-threshold: 50
  slow-call-duration-threshold: 2s
  slow-call-rate-threshold: 50
  wait-duration-in-open-state: 30s
  permitted-number-of-calls-in-half-open-state: 5

Что важно:

• медленные вызовы считаются отдельным порогом — именно они чаще кладут сервис;
• таймаут у HTTP-клиента обязателен — breaker его не заменяет;
• порядок аспектов Retry и CircuitBreaker определяет, считаются ли повторы ошибками;
• fallback должен быть осмысленным: кэш, значение по умолчанию, отложенная обработка — или честная ошибка;
• состояние — в /actuator/circuitbreakers, плюс алерты.