...
Eroare System Design · Cozi de mesaje și procesare asincronă

Brokerul de mesaje unic a căzut și comenzile nu se mai pot plasa

Pe scurt

Toate comenzile publică un eveniment în coadă, iar brokerul rulează într-o singură instanță: când cade, publicarea eșuează și comenzile dau erori. Rulează brokerul în cluster (de exemplu 3 noduri, cozi replicate) sau folosește un serviciu gestionat.

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

Ce înseamnă

Coada pare o componentă „din spate”, dar dacă aplicația publică sincron un eveniment la fiecare scriere, brokerul e pe drumul cererii. Un singur nod RabbitMQ sau Kafka devine astfel un punct unic de eșec: la cădere, publish aruncă excepții (Connection refused, AMQP connection closed, TimeoutException), iar comenzile eșuează.

Mai grav, mesajele aflate doar pe nodul căzut pot fi pierdute dacă nu erau persistate sau replicate.

Soluții: un cluster de brokeri cu cozi replicate (RabbitMQ quorum queues pe 3 noduri, Kafka cu replication.factor=3 și min.insync.replicas=2) sau un serviciu gestionat (SQS, Pub/Sub, Amazon MQ cu redundanță). Ca protecție suplimentară, aplicația poate salva evenimentul în bază, în aceeași tranzacție cu comanda (outbox pattern), iar un proces separat îl publică când brokerul revine.

De ce apare: cauzele frecvente

1Un singur broker

Greșit
rabbitmq: 1 nod, coadă clasică necopiată
Corect
rabbitmq: 3 noduri, x-queue-type = quorum

Cozile quorum sunt replicate pe majoritatea nodurilor și supraviețuiesc căderii unuia.

2Publicare directă, fără plasă de siguranță

Greșit
repo.save(comanda);
broker.publica(eveniment);   // dacă brokerul e căzut, comanda dă eroare
Corect
@Transactional
void plaseaza(Comanda c) {
    repo.save(c);
    outbox.save(new Eveniment("ComandaPlasata", c.id()));
}
// un proces separat publică din outbox

Comanda și evenimentul se salvează atomic; publicarea se face când brokerul e disponibil.

Repară tu

Repară eroarea, direct în pagină

Toate comenzile publică un eveniment într-o coadă cu un singur broker, care apare ca SPOF în simulare. Elimină punctul unic de eșec.

Indiciu

Coada scalează ca orice componentă: mai mulți brokeri.

Alte forme ale mesajului

  • java.net.ConnectException: Connection refused (AMQP)
  • org.apache.kafka.common.errors.TimeoutException: Topic comenzi not present in metadata after 60000 ms.
  • NOT_ENOUGH_REPLICAS

Cum o eviți pe viitor

  • Rulează brokerul în cluster, cu cozi / topicuri replicate.
  • Folosește acks=all și min.insync.replicas la Kafka pentru mesaje importante.
  • Ia în calcul outbox pattern pentru evenimentele legate de tranzacții.
  • Include brokerul în testele de cădere.

Întrebări frecvente

Un serviciu gestionat elimină problema?

SQS sau Pub/Sub sunt redundante intern, deci nu sunt SPOF-uri pe care să le gestionezi tu. Tot trebuie să tratezi erorile temporare de publicare.

Ce e outbox pattern?

Salvezi evenimentul într-un tabel outbox în aceeași tranzacție cu datele, iar un proces separat îl citește și îl publică. Nu pierzi evenimente și nu publici evenimente pentru tranzacții anulate.

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.