Circuit breaker: quando um serviço externo cai, o seu não precisa cair junto

Sistemas modernos dependem de serviços externos: pagamento, frete, mensageria, IA, ERP. Quando um deles fica lento ou cai, as requisições do seu sistema ficam esperando, os recursos se esgotam e, de repente, tudo está fora do ar.

A ideia do disjuntor

Como o disjuntor elétrico, o circuit breaker "desarma" quando detecta muitas falhas seguidas:

1. 1.Fechado: tudo normal, as chamadas passam.
2. 2.Aberto: depois de muitas falhas, as chamadas param imediatamente, sem esperar o serviço — e o sistema usa uma alternativa.
3. 3.Meio aberto: após um tempo, algumas chamadas de teste verificam se o serviço voltou.

Por que funciona

Em vez de cada requisição esperar 30 segundos por um serviço morto, ela falha em milissegundos e segue um plano B. O sistema principal continua respondendo.

Planos B possíveis

• Frete: tabela de preço padrão ou "calcularemos no próximo passo".
• Recomendações: produtos mais vendidos.
• IA: resposta padrão ou encaminhamento para humano.
• Pagamento: mensagem clara para tentar novamente em instantes.

É a lógica da Degradação graciosa: funcionar pela metade é melhor que sair do ar.

Peças que andam juntas

• Timeouts curtos e bem definidos (Timeouts: a configuração esquecida que derruba sistemas).
• Retentativas com backoff — mas nunca contra um circuito aberto (Gerenciando o erro 429 Too Many Requests: exponential backoff e retry no cliente).
• Monitoramento dos estados do circuito (Observabilidade para quem não é SRE: métricas, logs e traces).

A We Codex constrói integrações resilientes em sistemas web. Fale com a gente.