Exponential Backoff

Espaça as novas tentativas de uma chamada que falhou dobrando o atraso a cada tentativa, com teto e jitter. Evita que o retry imediato derrube de novo um serviço que está se recuperando e que vários clientes retentem no mesmo instante (thundering herd).

passos: 6
arquivos: 5
teste: 1
tecnologias: 4

Lógica puraTypeScriptBunElysiaStryker

Cenário Relações Comparar

Baixar cartão

Cenário

Uma fintech liquida PIX e TED por um gateway de pagamento externo — um processo Elysia real (api_gateway.ts, porta 4104) que responde 503 nas primeiras chamadas de cada operação. O cliente retenta com backoff exponencial e jitter até o limite de tentativas; quando o gateway continua fora, desiste com erro em vez de insistir para sempre.

Como funciona

6 passos

Espera dobra a cada nova tentativa.

Esconde cada passo: lembre antes de tocar para revelar.

Vocabulário compartilhado

fetch()+4

delayMax+1

Retry Pattern

attemptsMax+1

Retry Pattern

01
ExponencialA tentativa N espera delayBase × 2^(N-1) — 100, 200, 400 ms…
02
TetodelayMax impede que a tentativa 10 espere minutos
03
Full jitter (padrão recomendado): sorteia entre 0 e o delay com teto, espalhando os clientes
04
Equal jitterMetade fixa como piso, metade sorteada — quando é preciso garantir espera mínima
05
Limite de tentativasattemptsMax decide quando desistir; após a última falha não há espera
06
Chamada realCada tentativa é um fetch() ao gateway em outro processo; o log registra tentativa e delay

apps/patterns/exponential-backoff

5 arquivos

src/

exponential_backoff.tsbackoffDelayCapped, backoffDelayCalculate (none/full/equal) e backoffRetry com limite de tentativas
api_gateway.tsGateway Elysia (porta 4104) que falha nas N primeiras chamadas de cada operação
demo.tsdemoSobe o gateway com Bun.spawn, liquida PIX e TED com retry e compara as estratégias de jitter
exponential_backoff.test.tstesteUnitário com sorteio e sleep injetados: fronteira do teto e do limite de tentativas