...
Eroare Postman · Coduri de status 4xx și 5xx: ce înseamnă și cum le repari

500 Internal Server Error la un câmp prea lung (în loc de 422)

Pe scurt

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

Greșit
JavaScript
POST /products {"name": "<500 de caractere>", "price": 99}  → 500
Corect
JavaScript
# 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ă

Greșit
JavaScript
{"name": "Mouse test"}
Corect
JavaScript
pm.variables.set("numeLung", "a".repeat(500));
{"name": "{{numeLung}}"}

Valorile mari se generează în pre-request, nu se scriu de mână.

Repară tu

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”.

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

← Toate erorile Postman

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.