Plasarea comenzii durează secunde: emailul de confirmare e trimis sincron, în cerere
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
@PostMapping("/comenzi")
Comanda plaseaza(@RequestBody Cerere c) {
Comanda cmd = repo.save(c.toComanda());
email.trimiteConfirmare(cmd); // 1,5 s
return cmd;
}@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ă
evenimente.publica(new ComandaPlasata(cmd.id()));
email.trimiteConfirmare(cmd); // rămas din versiunea vecheevenimente.publica(new ComandaPlasata(cmd.id()));Apelul sincron rămas păstrează latența mare și trimite și emailuri duble.
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.
Reparația
1. Atinge conexiunea Server aplicație → Furnizor email și șterge-o.
Rezultat: comenzile răspund în ~120 ms, emailurile pleacă din workeri.
De ce merge
Apelul sincron rămas de la versiunea veche ținea fiecare comandă 1,5 secunde. Fără el, serverul doar publică evenimentul, iar workerii trimit emailul în fundal.
Alte forme ale mesajului
Request latency high: SMTP send in request threadjavax.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
upstream timed out (110: Connection timed out) while reading response header from upstream Linia din logul de erori nginx care stă în spatele unui 504: nginx a trimis cererea la server și nu a primit nici măcar antetele răspunsului în `proxy_read_timeout`. Caută ce face serverul atât de mult: o operație lungă ținută sincron (un apel extern, un raport) se mută într-un job asincron. Un serviciu extern lent blochează toate thread-urile serverului (timeout prea mare) Fiecare cerere apelează sincron un serviciu extern; când acesta devine lent, thread-urile serverului stau blocate până la timeout (adesea 30–60 de secunde sau infinit), iar serverul nu mai poate servi nimic. Pune timeout-uri scurte, potrivite cu durata normală a apelului, plus circuit breaker și fallback. Mesaje pierdute: consumatorul confirmă (ack) înainte să termine procesarea Consumatorul spune brokerului „am primit” (ack, commit de offset, delete în SQS) înainte să termine lucrul. Dacă procesul cade între confirmare și finalizare, mesajul e pierdut definitiv. Confirmă doar după ce efectul e salvat și fă procesarea idempotentă, pentru eventualele relivrări. Î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.
