"Vamos desacoplar isso com um evento" é uma frase que resolve problemas reais de escala — e também é a frase que mais vimos transformar um sistema simples em um quebra-cabeça de filas, tópicos e handlers que ninguém mais entende sozinho seis meses depois.
Event-driven architecture não é melhor ou piores que chamadas síncronas. É uma troca: você ganha desacoplamento e resiliência a picos, e paga com complexidade operacional, latência de ponta a ponta mais difícil de rastrear e uma classe nova de bugs de ordenação e duplicação.
Quando o evento realmente vale a complexidade
Existem três sinais que, juntos, indicam que vale a pena introduzir mensageria assíncrona:
- O consumidor pode processar depois. Se o usuário não precisa de resposta imediata — como enviar um e-mail de confirmação — o evento desacopla sem custo de UX.
- Picos de carga são desiguais entre produtor e consumidor. Um endpoint que recebe 10x mais tráfego do que o serviço downstream consegue processar precisa de uma fila como buffer, não de mais réplicas síncronas.
- Múltiplos consumidores precisam do mesmo dado. Quando três serviços diferentes precisam reagir ao mesmo evento de domínio, publicar uma vez é mais simples do que o produtor chamar três APIs síncronas.
O erro clássico: virar evento o que devia ser uma chamada
Vemos times transformarem em evento operações que precisam de resposta imediata e síncrona — como validar um CPF antes de finalizar um cadastro. O resultado é uma UI que precisa fazer polling, um spinner que gira por tempo indeterminado, e uma experiência pior do que uma chamada REST simples teria entregado.
Se o usuário está esperando uma resposta na tela, a resposta deveria vir de uma chamada síncrona. Evento é para o que pode esperar.
Idempotência não é opcional
Toda fila moderna garante entrega at-least-once, não exactly-once. Isso significa que o seu handler vai, eventualmente, receber a mesma mensagem duas vezes — e precisa lidar com isso sem duplicar efeito colateral (cobrar duas vezes, enviar dois e-mails, criar dois registros).
A solução prática é um identificador de idempotência por mensagem, persistido antes de processar, checado antes de aplicar qualquer efeito.