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

504 Gateway Timeout

Pe scurt

Gateway-ul (nginx, load balancer) a așteptat prea mult după serverul aplicației și a renunțat. Endpointul e prea lent pentru limita gateway-ului: raportează lentoarea, iar pentru operațiile lungi verifică dacă API-ul are o variantă asincronă (202 + job).

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

Ce înseamnă

504 vine de la gateway-ul dintre tine și aplicație: a trimis cererea mai departe, dar aplicația nu a răspuns în timpul lui maxim (des 30 sau 60 de secunde). Aplicația poate termina operația după aceea, deci un POST care a dat 504 poate să fi creat totuși resursa.

Diferențe importante:

  • 504 e un răspuns HTTP de la gateway;
  • ESOCKETTIMEDOUT e timeout-ul propriului client (Postman), fără răspuns;
  • 502 e un răspuns invalid sau o conexiune refuzată, nu o așteptare prea lungă.

Ce faci: măsori cât durează endpointul (Console, timpii), verifici dacă problema apare doar cu anumiți parametri (perioade lungi, fără paginare) și raportezi cu acele detalii. După un 504 la un POST, verifici cu un GET dacă resursa s-a creat, înainte să trimiți din nou.

De ce apare: cauzele frecvente

1Operație lungă sincronă

Greșit
JavaScript
GET {{baseUrl}}/reports/sales?period=2020-2026   → 504
Corect
JavaScript
GET {{baseUrl}}/reports/sales?period=2026-10

Un interval mai mic reduce timpul de procesare.

2POST retrimis după 504

Greșit
JavaScript
POST /orders  → 504
POST /orders  (din nou)
Corect
JavaScript
GET /orders  # verifică dacă s-a creat
# sau trimite cu Idempotency-Key

Prima cerere poate să fi reușit pe server.

Repară tu

Repară eroarea, direct în pagină

Cererea „Raport” (un endpoint care durează aproximativ 2 secunde) nu are nicio limită de timp proprie, deci un client ar aștepta cât decide gateway-ul. Setează în Settings-ul cererii un timeout explicit de 5000 ms, salvează și trimite: trebuie să primești 200.

Indiciu

Request timeout din tabul Settings al cererii.

Alte forme ale mesajului

  • 504 Gateway Time-out nginx
  • HTTP 504
  • The gateway did not receive a timely response from the upstream server

Cum o eviți pe viitor

  • Setează un timeout explicit în Settings-ul cererilor lente, ca să știi exact cât aștepți.
  • Folosește Idempotency-Key la operațiile de creare, ca retrimiterea să fie sigură.
  • Raportează endpointurile care se apropie de limita gateway-ului.
  • Măsoară timpul operațiilor lente și discută cu echipa varianta asincronă.
  • Nu crește la nesfârșit timeout-ul clientului.

Întrebări frecvente

Cererea a fost procesată?

Poate. Gateway-ul a renunțat, dar aplicația poate fi terminat operația. Verifică înainte de a retrimite.

De ce nu văd 504 în Postman, ci timeout?

Dacă timeout-ul tău e mai mic decât al gateway-ului, Postman renunță primul și vezi ESOCKETTIMEDOUT.

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.