De reținut
- Majoritatea broker-elor garantează livrarea at-least-once (cel puțin o dată), așa că consumatorii vor primi duplicate. Ordinea e garantată de obicei doar în cadrul unei partiții sau al unei chei. Proiectează testele în jurul acestor garanții reale, nu al fluxului fericit.
- Testează intenționat cazurile grele: duplicate, reordonare, mesaje otrăvite, consumatori care cad la jumătatea procesării, căderi ale broker-ului și schimbări de schemă.
- Înlocuiește
sleep()cu verificări de tip „eventually” (până la urmă): interoghezi până când o condiție devine adevărată sau expiră un timeout. Verifică stări finale și invarianți, nu sincronizarea.
De unde pornim
Ai văzut modurile de defectare ale sistemelor distribuite și cum poate observabilitatea să arate ce se întâmplă după ce un API răspunde. Arhitecturile bazate pe evenimente fac din asincronie regula: serviciile comunică publicând și consumând evenimente prin broker-e precum Kafka, RabbitMQ sau cozile din cloud.
Garanțiile pe care le primești de fapt
| Preocupare | Realitatea obișnuită | Consecința pentru testare |
|---|---|---|
| Livrarea | At-least-once: mesajele pot fi relivrate după defecțiuni sau rebalansări | Fiecare consumator trebuie să fie idempotent; testează explicit duplicatele |
| Ordinea | Doar pe partiție sau pe cheie; între chei, nicio ordine | Testează evenimente pentru aceeași entitate care sosesc în altă ordine, dacă cheile pot diferi, și între partiții |
| Consistența | Eventuală: modelele de citire și celelalte servicii se actualizează mai târziu | Testele trebuie să aștepte condiții, iar produsul trebuie să trateze citirile depășite |
| „Exactly-once” | De obicei procesare exactly-once doar în anumite limite, nu livrare cap-coadă | Nu o presupune între sisteme; testează efectele secundare, precum e-mailurile și plățile, pentru duplicate |
Ce testezi
Idempotența
Livrează același eveniment de două ori sau de zece ori, cu același ID. Rezultatul trebuie să fie același ca la o singură livrare: o comandă, un e-mail, o plată, un bonus de fidelitate. Testează și relivrarea după procesare parțială: consumatorul a actualizat baza de date, apoi a căzut înainte să confirme mesajul.
Ordinea
Pentru aceeași entitate, trimite „adresa schimbată” și „comanda expediată” în ambele ordini. Sistemul tratează corect evenimentul întârziat, folosind numere de versiune, timestamp-uri sau condiții de stare, ori suprascrie datele noi cu unele mai vechi?
Mesajele otrăvite și reîncercările
Un mesaj malformat sau imposibil de procesat nu trebuie să blocheze coada la nesfârșit. Testează că e reîncercat de un număr limitat de ori, cu pauze tot mai mari, apoi mutat într-o dead-letter queue, cu o alertă, și că mesajele următoare continuă să curgă.
Defecțiuni în timpul procesării
Oprește consumatorul la jumătatea unui mesaj. Oprește broker-ul și pornește-l din nou. Fă o dependență din aval să cedeze. Apoi verifică: niciun mesaj pierdut, niciun efect secundar dublat, procesarea se reia.
Outbox-ul tranzacțional
Când un serviciu trebuie să actualizeze baza de date și să publice un eveniment, dacă le face separat riscă să facă doar una dintre ele. Tiparul outbox scrie evenimentul într-un tabel, în aceeași tranzacție, iar un releu îl publică. Testează căderile dintre scriere și publicare și verifică dacă releul livrează, până la urmă, exact evenimentele confirmate.
Evoluția schemelor
Producătorii și consumatorii se lansează independent, așa că evenimente cu scheme vechi și noi coexistă. Folosește un schema registry cu reguli de compatibilitate sau contracte pentru mesaje și testează dacă consumatorii tratează atât versiunile vechi, cât și pe cele noi, precum și câmpurile necunoscute.
Fluxuri de lungă durată (saga)
Procesele de business în mai mulți pași, prin mai multe servicii, precum rezervarea stocului, încasarea cardului și expedierea, folosesc acțiuni de compensare atunci când un pas eșuează. Testează eșecul la fiecare pas și verifică dacă acțiunile de compensare lasă sistemul consistent.
Înlocuirea sleep-urilor cu „eventually”
def eventually(conditie, timeout=10.0, interval=0.1):
termen = time.monotonic() + timeout
while time.monotonic() < termen:
if conditie():
return
time.sleep(interval)
raise AssertionError("condiția nu a fost îndeplinită în timpul permis")
publish(OrderPlaced(order_id="o-1"))
eventually(lambda: read_model.get("o-1").status == "CONFIRMED")
eventually(lambda: emails_sent_to("ana@example.com") == 1)
Testul trece imediat ce condiția e adevărată și pică clar dacă nu devine niciodată adevărată. Apoi adaugă, unde contează, o verificare că „rămâne adevărat”, de exemplu că numărul de e-mailuri e tot 1 după câteva secunde, ca să prinzi duplicatele întârziate.
O abordare pe straturi
| Strat | Ce testează | Cum |
|---|---|---|
| Teste unitare pentru handler-e | Logica fiecărui eveniment, regulile de idempotență | Apelezi direct handler-ul cu evenimente, inclusiv duplicate și versiuni vechi |
| Contracte pentru mesaje | Producătorul și consumatorul sunt de acord asupra formei evenimentelor | Teste de contract sau de compatibilitate a schemelor, în fiecare pipeline |
| Integrare cu un broker real | Serializare, confirmări, reîncercări, rutare spre dead-letter queue | Un broker într-un container, în timpul testelor |
| Injectare de defecte | Căderi, întreruperi ale broker-ului, consumatori lenți | Oprești și repornești procese; pui broker-ul pe pauză; injectezi latență |
| Fluxuri end-to-end | Câteva parcursuri critice prin mai multe servicii | Verificări „eventually” plus invarianți |
Serviciul de fidelitate al unui retailer consuma evenimente „comandă plătită” și adăuga puncte. Toate testele treceau: un eveniment, un set de puncte.
În timpul unei reduceri de weekend, broker-ul a rebalansat de mai multe ori partițiile consumatorilor, sub încărcare. Mesajele procesate, dar încă neconfirmate, au fost relivrate, iar mii de clienți au primit puncte duble.
Echipa a făcut handler-ul idempotent, înregistrând ID-urile evenimentelor procesate în aceeași tranzacție cu actualizarea punctelor. A adăugat teste care livrau fiecare eveniment de două ori, opreau consumatorul între procesare și confirmare și verificau invariantul „punctele sunt egale cu suma comenzilor plătite distincte”.
Lecția: livrarea at-least-once înseamnă că duplicatele nu sunt un caz-limită; sunt garantate să apară, mai devreme sau mai târziu. Testele trebuie să le livreze intenționat.
Așa da
Să verifici invarianți precum „efectul secundar al fiecărui eveniment are loc o singură dată” în timp ce livrezi duplicate, reordonezi evenimente și repornești consumatorii în mijlocul fluxului.
Așa nu
Să publici un eveniment, să aștepți cinci secunde și să verifici baza de date. E lent, instabil și orb la duplicate, la ordine și la recuperarea după căderi.
Verifică-te
Un model de citire e actualizat asincron, din evenimente. Un test de UI pică uneori pentru că noua comandă încă nu e vizibilă. Care e soluția corectă în test și ce întrebare ar trebui să pui despre produs?
Arată răspunsul
În test, înlocuiește orice așteptare fixă cu o verificare „eventually”, care interoghează până când comanda apare sau expiră un timeout. Despre produs, întreabă: ce vede utilizatorul în timpul întârzierii? Dacă un utilizator poate plasa o comandă și apoi nu o găsește, e o problemă de usability, care poate cere un comportament de tip read-your-own-writes sau o stare clară de „în procesare”, și merită testată și ea.
