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

Plasarea comenzii durează secunde: emailul de confirmare e trimis sincron, în cerere

Pe scurt

Cererea de plasare a comenzii așteaptă furnizorul de email (SMTP sau API), care răspunde în secunde, deci clientul așteaptă și el. Emailul nu trebuie să fie gata înainte de răspuns: publică un eveniment în coadă și lasă workerii să-l trimită.

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

Ce înseamnă

Trimiterea unui email pare o operație mică, dar implică o conexiune la un server extern, autentificare și, uneori, reîncercări. Un SMTP lent sau un API de email cu probleme adaugă una-două secunde la fiecare comandă, iar când furnizorul cade, comenzile încep să dea erori, deși comanda putea fi salvată fără probleme.

E un caz clasic de cuplare temporală: cererea utilizatorului depinde de o operație care nu e necesară pentru răspuns. Testul simplu: „are clientul nevoie de rezultatul acestui pas ca să primească răspunsul?” Pentru salvarea comenzii, da. Pentru email, nu.

Cu o coadă, cererea salvează comanda, publică ComandaPlasata și răspunde imediat. Workerii trimit emailul, cu reîncercări și DLQ, fără să afecteze latența sau disponibilitatea plasării comenzii. O greșeală frecventă la migrare: coada există, dar codul vechi încă trimite și sincron.

De ce apare: cauzele frecvente

1Email trimis în cerere

Greșit
@PostMapping("/comenzi")
Comanda plaseaza(@RequestBody Cerere c) {
    Comanda cmd = repo.save(c.toComanda());
    email.trimiteConfirmare(cmd);   // 1,5 s
    return cmd;
}
Corect
@PostMapping("/comenzi")
Comanda plaseaza(@RequestBody Cerere c) {
    Comanda cmd = repo.save(c.toComanda());
    evenimente.publica(new ComandaPlasata(cmd.id()));
    return cmd;
}

Comanda răspunde în milisecunde; emailul pleacă din worker.

2Migrare incompletă: trimitere dublă

Greșit
evenimente.publica(new ComandaPlasata(cmd.id()));
email.trimiteConfirmare(cmd);   // rămas din versiunea veche
Corect
evenimente.publica(new ComandaPlasata(cmd.id()));

Apelul sincron rămas păstrează latența mare și trimite și emailuri duble.

Repară tu

Repară eroarea, direct în pagină

Coada și workerii de email există deja, dar serverul trimite emailul și direct, sincron, la furnizor (1,5 secunde), așa că plasarea comenzii durează. Fă ca scrierile să răspundă în sub 300 ms, cu emailurile trimise doar de workeri.

Indiciu

Uită-te la toate săgețile care ajung la Furnizor email.

Alte forme ale mesajului

  • Request latency high: SMTP send in request thread
  • javax.mail.MessagingException: Could not connect to SMTP host (comanda eșuează)

Cum o eviți pe viitor

  • Pune în cerere doar pașii de care depinde răspunsul.
  • Trimite emailurile, notificările și procesările lente prin coadă.
  • Verifică după migrare că nu a rămas și apelul sincron.
  • Monitorizează separat latența plasării comenzii și întârzierea emailurilor.

Întrebări frecvente

Și dacă emailul nu pleacă deloc?

Workerul reîncearcă, iar după câteva eșecuri mesajul ajunge în DLQ, cu alertă. Comanda e oricum salvată; emailul poate fi retrimis.

Clientul nu trebuie să știe că emailul a plecat?

De obicei nu: pagina de confirmare spune că emailul va sosi. Dacă e necesar, starea trimiterii se poate afișa ulterior.

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.