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

502 Bad Gateway

Pe scurt

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.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Între Postman și aplicație stă adesea un gateway: nginx, un load balancer, un API gateway din cloud. 502 e răspunsul gateway-ului când serverul din spatele lui nu a răspuns corect: conexiune refuzată, răspuns stricat, proces căzut.

Indicii utile:

  • body-ul e adesea o pagină HTML a gateway-ului (<center>nginx</center>), nu JSON-ul API-ului;
  • toate endpointurile dau 502 în același timp, nu doar unul;
  • apare în timpul unui deploy și dispare după un minut.

Ca tester, verifici /health și alte endpointuri: dacă toate dau 502, aplicația e jos și anunți echipa. Dacă doar unul dă 502, probabil acea cerere oprește procesul (un bug grav de raportat). În testele automate, o verificare globală „fără 5xx” transformă situația într-un eșec clar, nu în zeci de erori de parsare JSON.

De ce apare: cauzele frecvente

1Aplicația din spatele gateway-ului e oprită

Greșit
JavaScript
GET {{baseUrl}}/products   → 502 (nginx)
Corect
JavaScript
# verifică /health, anunță echipa, reîncearcă după deploy

Gateway-ul nu are cui să trimită cererea.

2O cerere anume oprește procesul

Greșit
JavaScript
POST /import (fișier mare)  → 502
Corect
JavaScript
# raportează: cererea care provoacă oprirea aplicației

Dacă doar acea cerere dă 502, aplicația cade la procesarea ei.

Repară tu

Repară eroarea, direct în pagină

Unele cereri primesc 502 de la gateway, iar testele lor dau erori de parsare greu de citit. Adaugă în scriptul Post-response al colecției „Magazin” un test „Fără eroare de server” care verifică pm.response.code sub 500, apoi trimite „Health”: testul trebuie să treacă.

Indiciu

Scriptul colecției rulează pentru fiecare cerere din ea.

Alte forme ale mesajului

  • 502 Bad Gateway nginx
  • HTTP 502
  • <html><head><title>502 Bad Gateway</title></head>

Cum o eviți pe viitor

  • Pune o verificare globală pentru 5xx în scriptul colecției.
  • Nu rula suita în timpul deploy-urilor.
  • Un monitor pe /health anunță căderile înainte de teste.
  • Verifică dacă serviciul din spatele gateway-ului rulează înainte să cauți probleme în cerere.

Întrebări frecvente

Ce diferență e între 502 și 504?

502: gateway-ul a primit un răspuns invalid sau o conexiune refuzată. 504: gateway-ul a așteptat prea mult și n-a primit nimic.

De ce body-ul e HTML?

Răspunsul e generat de gateway, care are propriile pagini de eroare, nu de API.

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.