500 Internal Server Error
Serverul a avut o eroare neprevăzută în timp ce procesa cererea: e o problemă în API, nu în Postman. Repetă o dată, apoi raportează bug-ul cu cererea exactă, ora și ID-ul de corelare (requestId) din răspuns, ca dezvoltatorii să găsească eroarea în loguri.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
500 spune doar că ceva a mers prost pe server: o excepție netratată, o interogare eșuată, un serviciu dependent căzut. Serverul nu explică (și nici nu ar trebui să explice) detaliile clientului.
Ce poți face ca tester:
- verifici dacă cererea e corectă: o cerere invalidă ar trebui să primească 400 sau 422, nu 500. Un 500 la input greșit e tot bug, pentru că validarea lipsește;
- repeți cererea o dată, ca să vezi dacă problema e constantă;
- strângi informațiile pentru raport: cererea completă (cURL, fără secrete), ora exactă, mediul și ID-ul de corelare (
requestIdîn body sau un antetX-Request-Id), cu care dezvoltatorii găsesc imediat stack trace-ul în loguri.
Verifici și ce nu trebuie să apară în răspuns: stack trace, interogări SQL, căi de fișiere.
De ce apare: cauzele frecvente
1Endpoint stricat pe server
GET {{baseUrl}}/reports/export → 500# raport de bug cu cererea, ora și requestIdClientul nu poate repara serverul; un raport bun scurtează investigația.
2Input neașteptat netratat
POST /products {"name": "<5000 de caractere>"}# serverul ar trebui să răspundă 422 cu detaliiUn 500 la date invalide arată că validarea lipsește.
Repară eroarea, direct în pagină
Cererea „Export rapoarte” (GET {{baseUrl}}/reports/export) răspunde mereu 500, cu un requestId în body. Problema e pe server, deci reparația ta e un raport complet: creează un raport de bug cu titlu, pași, rezultat așteptat și rezultat obținut (inclusiv requestId), cu ultima cerere atașată.
Indiciu
Rapoartele se creează din secțiunea Bug-uri; atașează ultima cerere.
Reparația
Raport de bug:
- Titlu: GET /reports/export răspunde 500 Internal Server Error
- Pași: trimite GET {{baseUrl}}/reports/export pe Dev
- Așteptat: 200 cu fișierul exportat
- Obținut: 500
internal_error, curequestIddin body - atașează ultima cerere
De ce merge
Un 500 nu se repară din Postman. Contribuția testerului e un raport pe care dezvoltatorul îl poate folosi imediat: cererea exactă și requestId-ul, cu care găsește eroarea în loguri fără să o reproducă. 500 e o eroare a serverului, nu a cererii tale. Din Postman poți doar s-o reproduci și s-o raportezi clar; requestId din răspuns îi ajută pe dezvoltatori să găsească eroarea în loguri.
Alte forme ale mesajului
500 Internal Server Error: A apărut o eroare neașteptată.HTTP 500{"error": "internal_error"}
Cum o eviți pe viitor
- Pune un test global „fără erori de server” (
pm.expect(pm.response.code).to.be.below(500)) în colecție. - Raportează fiecare 500 cu ID-ul de corelare.
- Verifică în teste că erorile nu expun detalii interne.
- Când raportezi un 500, include cererea completă, ora și
requestIddin răspuns.
Întrebări frecvente
E vina mea că am primit 500?
Nu. Chiar dacă cererea ta e greșită, serverul trebuie să răspundă cu 4xx, nu cu 500.
Ce pun în raport?
Cererea (cURL fără tokenuri), răspunsul, ora, mediul, requestId și pașii de reproducere.
Erori înrudite
500 Internal Server Error la un câmp prea lung (în loc de 422) Serverul cade când primește o valoare mai lungă decât acceptă baza de date, în loc să o valideze și să răspundă 422. E un bug de validare: raportează-l cu lungimea exactă care îl declanșează și cu răspunsul așteptat (422 cu detalii pe câmp). 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. 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. Î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.
