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).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un API corect validează datele înainte să le scrie. Dacă un câmp name are în baza de date limita de 120 de caractere, dar API-ul nu verifică lungimea, o valoare de 500 de caractere ajunge la baza de date, care aruncă o excepție, iar clientul primește 500.
De ce contează, deși „e doar un input ciudat”:
- clientul nu află ce a greșit (422 ar spune exact câmpul și limita);
- logurile se umplu de erori, iar alertele reale se pierd;
- uneori mesajul de 500 scapă detalii interne (tabela, interogarea);
- e semn că alte validări lipsesc.
Testul tipic: valori la limită și peste limită pentru fiecare câmp text ("a".repeat(121) generat în pre-request). Raportul bun spune lungimea minimă care produce 500 și ce ar trebui să se întâmple.
De ce apare: cauzele frecvente
1Lipsa validării de lungime
POST /products {"name": "<500 de caractere>", "price": 99} → 500# așteptat: 422 {"field": "name", "message": "maximum 120 de caractere"}Validarea trebuie să oprească valoarea înainte de baza de date.
2Test fără valori limită
{"name": "Mouse test"}pm.variables.set("numeLung", "a".repeat(500));
{"name": "{{numeLung}}"}Valorile mari se generează în pre-request, nu se scriu de mână.
Repară eroarea, direct în pagină
Ca admin, ai trimis POST /products cu un nume de 300 de caractere și ai primit 500 în loc de 422 (bug-ul e pornit în acest mediu). Raportează bug-ul: titlul trebuie să spună că un nume foarte lung produce 500, cu pași, rezultat așteptat (422 cu detalii pe câmp) și rezultat obținut, cu ultima cerere atașată.
Indiciu
Titlul trebuie să conțină „500” și „nume”.
Reparația
Raport:
- Titlu: POST /products: un nume foarte lung (300 de caractere) produce 500 în loc de 422
- Pași: login admin; POST /products cu
namede 300 de caractere - Așteptat: 422
validation_error, cu detalii pe câmpulname - Obținut: 500
internal_error - atașează ultima cerere
De ce merge
Bug-ul nu se repară din Postman, ci se documentează precis: lungimea care îl declanșează și răspunsul corect așteptat. Cu aceste date, dezvoltatorul adaugă validarea și un test pentru limită. Serverul ar trebui să valideze lungimea și să răspundă cu 400 sau 422, nu să cadă cu 500. Ai găsit un bug de validare; raportul cu pași clari și valoarea exactă îl face ușor de reprodus.
Cum o eviți pe viitor
- Testează fiecare câmp text la limită, imediat peste limită și cu o valoare foarte mare.
- Raportează orice 500 produs de input, chiar dacă inputul pare nerealist.
- Cere ca limitele să fie în specificație (
maxLengthîn OpenAPI). - Include în testele negative valori la limită: texte foarte lungi, caractere speciale, câmpuri goale.
Întrebări frecvente
E un bug major?
De obicei da: arată o validare lipsă și poate expune detalii interne. Severitatea crește dacă se repetă pe mai multe câmpuri.
Ce status ar trebui să primesc?
422 (sau 400, după convenția API-ului), cu câmpul și limita în detalii.
Erori înrudite
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. 422 Unprocessable Entity Body-ul e JSON valid, dar datele încalcă regulile: un câmp obligatoriu lipsește, un email are format greșit, o valoare e în afara limitelor sau are tipul greșit. Citește lista de erori din răspuns (de obicei pe câmpuri) și corectează exact câmpurile indicate. AssertionError: expected response to have status code 200 but got 201 Testul cere statusul 200, dar serverul a răspuns 201 Created. Pentru o creare reușită, 201 e răspunsul corect, deci testul greșește: verifică statusul pe care îl promite documentația endpoint-ului. Î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.
