...
Eroare System Design · SPOF, căderi în cascadă, securitate și monitorizare

CallNotPermittedException: CircuitBreaker 'plati' is OPEN and does not permit further calls

Pe scurt

Circuit breaker-ul din fața unei dependențe s-a deschis pentru că prea multe apeluri recente au eșuat sau au fost lente, deci respinge imediat apelurile noi o perioadă. Nu e cauza problemei, ci protecția: verifică dependența, tratează excepția cu un fallback și ajustează pragurile doar dacă sunt evident greșite.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Un circuit breaker (Resilience4j, Polly, opossum) numără rezultatele apelurilor spre o dependență. Cât timp rata de eșec sau de apeluri lente e sub prag, e CLOSED și apelurile trec. Când pragul e depășit într-o fereastră de apeluri, trece în OPEN și respinge imediat orice apel cu CallNotPermittedException, fără să mai contacteze dependența. După o pauză (waitDurationInOpenState), trece în HALF_OPEN și lasă câteva apeluri de probă; dacă reușesc, se închide.

Mesajul spune deci două lucruri: dependența (aici plati) a avut probleme recent, iar aplicația ta e protejată de a-și bloca thread-urile așteptând-o. Ce trebuie făcut: verifică starea dependenței (loguri, latență, erori), asigură-te că excepția e tratată cu un răspuns util (mesaj clar, plată reîncercată mai târziu, coadă) și nu se transformă într-un 500.

Pragurile prea agresive (fereastră de 5 apeluri, 50% eșec) pot deschide breaker-ul la câteva erori izolate; cele prea permisive nu protejează nimic.

De ce apare: cauzele frecvente

1Excepția nu e tratată

Greșit
@CircuitBreaker(name = "plati")
public Rezultat plateste(Comanda c) { return client.plateste(c); }
Corect
@CircuitBreaker(name = "plati", fallbackMethod = "plataAmanata")
public Rezultat plateste(Comanda c) { return client.plateste(c); }

Rezultat plataAmanata(Comanda c, CallNotPermittedException e) {
    return Rezultat.inAsteptare("Plata va fi reîncercată în câteva minute.");
}

Utilizatorul primește un răspuns clar, nu o eroare 500.

2Fereastră prea mică

Greșit
resilience4j.circuitbreaker.instances.plati.slidingWindowSize: 5
Corect
resilience4j.circuitbreaker.instances.plati.slidingWindowSize: 50
resilience4j.circuitbreaker.instances.plati.minimumNumberOfCalls: 20

Câteva erori izolate nu mai deschid breaker-ul.

Repară tu

Repară eroarea, direct în pagină

Răspunde la cele trei întrebări despre breaker-ul deschis la serviciul de plăți.

Indiciu

Breaker-ul e un simptom: ce s-a întâmplat înainte să se deschidă?

Alte forme ale mesajului

  • io.github.resilience4j.circuitbreaker.CallNotPermittedException
  • Polly.CircuitBreaker.BrokenCircuitException: The circuit is now open and is not allowing calls.
  • Breaker is open (opossum)

Cum o eviți pe viitor

  • Pune circuit breaker pe apelurile spre dependențe externe și interne importante.
  • Definește un fallback pentru fiecare.
  • Alertează când un breaker se deschide.
  • Alege pragurile după volumul real de apeluri.

Întrebări frecvente

Cât stă breaker-ul deschis?

Cât e configurat în waitDurationInOpenState (de exemplu 30 de secunde). Apoi trimite apeluri de probă.

Breaker-ul face reîncercări?

Nu. Reîncercările (retry) sunt un mecanism separat; combinate, retry-ul trebuie să fie în interiorul breaker-ului și limitat.

Erori înrudite

← Toate erorile System Design

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață System Design de la zero, cu exerciții la fiecare lecție

Curs System Design: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.