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

500 Internal Server Error

Pe scurt

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 antet X-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

Greșit
JavaScript
GET {{baseUrl}}/reports/export   → 500
Corect
JavaScript
# raport de bug cu cererea, ora și requestId

Clientul nu poate repara serverul; un raport bun scurtează investigația.

2Input neașteptat netratat

Greșit
JavaScript
POST /products {"name": "<5000 de caractere>"}
Corect
JavaScript
# serverul ar trebui să răspundă 422 cu detalii

Un 500 la date invalide arată că validarea lipsește.

Repară tu

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.

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 requestId din 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

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