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

Mesajele stau în coadă și nu le procesează nimeni (niciun consumator conectat)

Pe scurt

Producătorul publică mesaje, dar niciun consumator nu e abonat la coadă (worker oprit, nume de coadă greșit, binding lipsă), deci mesajele se adună sau, într-un exchange fără coadă, se pierd. Pornește workerii și verifică că ascultă exact coada (sau topicul) în care publici.

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

Ce înseamnă

Simptomul: comenzile se plasează, dar emailurile nu pleacă, facturile nu se generează, iar numărul de mesaje din coadă crește. În consola brokerului, coada are consumers: 0.

Cauzele sunt banale și frecvente: deploy-ul workerilor a eșuat și nimeni nu a observat (aplicația web merge, deci nu sună nicio alarmă); producătorul publică în comenzi.noi, iar consumatorul ascultă comenzi-noi; în RabbitMQ, mesajul e publicat într-un exchange fără binding spre vreo coadă (și se pierde în tăcere, dacă nu e setat mandatory); în Kafka, consumatorul are alt group.id sau citește de la latest și ratează mesajele vechi.

Coada fără consumator e periculoasă tocmai pentru că e tăcută: totul pare să funcționeze pentru utilizator, până când observă că nu primește nimic.

De ce apare: cauzele frecvente

1Nume de coadă diferit la producător și consumator

Greșit
producator.send("comenzi.noi", mesaj);
@RabbitListener(queues = "comenzi-noi")
Corect
public static final String COADA = "comenzi.noi";
producator.send(COADA, mesaj);
@RabbitListener(queues = COADA)

O singură constantă (sau configurație) pentru numele cozii elimină nepotrivirea.

2Workerii nu rulează

Greșit
kubectl get deploy workeri-email
# READY 0/3
Corect
kubectl rollout status deploy/workeri-email
# alertă: consumers == 0 pe coada comenzi.noi

O alertă pe numărul de consumatori prinde imediat situația.

Repară tu

Repară eroarea, direct în pagină

Serverul publică evenimentele comenzilor într-o coadă, dar workerii nu au fost conectați niciodată: emailurile de confirmare nu pleacă. Adaugă consumatorii și conectează-i la coadă, cu destulă capacitate pentru 300 de mesaje pe secundă.

Indiciu

Avertismentul cozii din tab-ul Simulare spune ce lipsește.

Alte forme ale mesajului

  • Queue has 0 consumers
  • RabbitMQ: message returned, NO_ROUTE
  • SQS: ApproximateNumberOfMessagesVisible în creștere, niciun receive

Cum o eviți pe viitor

  • Alertează când o coadă importantă are zero consumatori.
  • Alertează pe vechimea celui mai vechi mesaj.
  • Ține numele cozilor și topicurilor într-o singură configurație comună.
  • În RabbitMQ, folosește mandatory sau alternate exchange ca să nu pierzi mesaje fără rută.

Întrebări frecvente

Mesajele se pierd dacă nu e niciun consumator?

Într-o coadă durabilă, nu: așteaptă până la limita de retenție (SQS: implicit 4 zile, maxim 14). Într-un exchange fără coadă legată sau într-un pub/sub fără abonați, da.

De ce nu observ problema din aplicația web?

Pentru că publicarea reușește. Doar efectele asincrone (emailuri, procesări) lipsesc, deci ai nevoie de monitorizare pe coadă.

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.