503 Service Unavailable
Serviciul e temporar indisponibil: în mentenanță, supraîncărcat sau încă pornește după un deploy. Răspunsul poate avea antetul Retry-After. Reîncearcă mai târziu și verifică /health; dacă persistă, anunță echipa.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
503 e răspunsul „nu pot acum”: serverul există, dar refuză temporar cererile. Situații tipice:
- mentenanță planificată sau un deploy în curs;
- serviciul e supraîncărcat și respinge cereri ca să se protejeze;
- o dependență critică (baza de date) e jos, iar health check-ul raportează serviciul ca indisponibil;
- containerul încă pornește și nu e „ready”.
Un 503 bine făcut include Retry-After, ca clienții să știe când să revină. Diferența față de 500: 503 e intenționat și temporar, 500 e o eroare neprevăzută.
Pentru suita de teste, merită un pas de verificare la început: dacă /health nu răspunde 200, rularea se oprește cu un mesaj clar, în loc de 200 de teste picate.
De ce apare: cauzele frecvente
1Teste rulate în timpul mentenanței
newman run c.json # în fereastra de deploy# rulează după deploy, sau verifică întâi /healthUn serviciu în mentenanță răspunde 503 la orice.
2Serviciu supraîncărcat de propriile teste
Runner: 500 iterații, Delay 0Runner: Delay 200 msRafalele mari pot declanșa protecția la supraîncărcare.
Repară eroarea, direct în pagină
Înainte de suita completă, vrei o verificare de disponibilitate care oprește totul dacă serviciul e în mentenanță (503). Pe cererea „Health”, scrie un test că statusul e 200 și altul că body-ul are status: "ok". Salvează cererea și trimite-o: ambele teste trebuie să treacă.
Indiciu
Folosește pm.response.json().status.
Reparația
pm.test("Serviciul e disponibil (200)", function () {
pm.response.to.have.status(200);
});
pm.test("Starea raportată e ok", function () {
pm.expect(pm.response.json().status).to.equal("ok");
});De ce merge
Pusă prima în colecție (sau rulată de un monitor), cererea Health spune imediat dacă serviciul e disponibil. La 503, ambele teste pică cu un mesaj clar, iar cauza tuturor eșecurilor de după e evidentă. 503 spune că serviciul e temporar indisponibil (mentenanță, supraîncărcare). Antetul Retry-After, când există, îți spune când să încerci din nou; până atunci, nu e nimic de reparat în cerere.
Alte forme ale mesajului
503 Service Unavailable: Service temporarily unavailableHTTP 503
Cum o eviți pe viitor
- Începe suita cu o cerere
/healthcu test pe 200 și oprește rularea dacă pică. - Respectă
Retry-After. - Corelează rulările din CI cu ferestrele de deploy.
- Verifică pagina de status sau canalul echipei pentru mentenanță planificată.
- În Runner și CI, tratează 503 separat de bug-urile funcționale, ca să nu raportezi greșit.
Întrebări frecvente
Trebuie raportat ca bug?
Nu, dacă e mentenanță anunțată. Da, dacă apare neanunțat sau la încărcări mici.
Ce diferență e între 503 și 429?
429 privește clientul tău (prea multe cereri de la tine). 503 privește serverul (indisponibil pentru toți).
Erori înrudite
502 Bad Gateway Un proxy sau un gateway (nginx, load balancer, API gateway) a primit un răspuns invalid sau niciun răspuns de la serverul aplicației. De obicei aplicația din spate e oprită, repornește sau a căzut. Verifică /health și anunță echipa; nu e o problemă a cererii tale. 504 Gateway Timeout Gateway-ul (nginx, load balancer) a așteptat prea mult după serverul aplicației și a renunțat. Endpointul e prea lent pentru limita gateway-ului: raportează lentoarea, iar pentru operațiile lungi verifică dacă API-ul are o variantă asincronă (202 + job). 429 Too Many Requests Ai depășit limita de cereri a API-ului (rate limiting). Așteaptă numărul de secunde din antetul Retry-After, pune o pauză între cereri în Runner și Newman și scrie teste care tratează 429 separat de erorile reale. Învață Postman de la zero, cu exerciții la fiecare lecție
Curs API Testing cu Postman: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
