...
Eroare n8n · HTTP Request și API-uri

The connection timed out, consider setting the 'Retry on Fail' option in the node settings

Pe scurt

Serverul nu a răspuns în timpul permis (ETIMEDOUT / timeout of ...ms exceeded): e lent, supraîncărcat sau inaccesibil din rețeaua n8n. Activează Retry On Fail pentru căderi ocazionale, mărește Options → Timeout pentru operații lente și verifică dacă n8n poate ajunge la server.

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

Ce înseamnă

Mesajul apare când conexiunea sau răspunsul nu vin la timp. În detalii poți vedea ETIMEDOUT, ESOCKETTIMEDOUT sau timeout of 300000ms exceeded. Spre deosebire de ECONNREFUSED (refuz imediat), aici cererea „atârnă” până expiră timpul.

Cauze: serverul e lent pentru operația cerută (un raport mare, un export), e supraîncărcat temporar, un firewall aruncă pachetele fără răspuns, sau adresa nu e accesibilă din rețeaua în care rulează n8n (IP intern, VPN).

Reparații: pentru căderi ocazionale, Retry On Fail (sugerat chiar de mesaj); pentru operații care chiar durează, Options → Timeout mai mare în HTTP Request; pentru volume mari, cere mai puține date pe cerere (paginare, filtre). Dacă timeout-ul apare mereu, verifică accesul la rețea: o cerere de test spre același server de pe mașina n8n.

De ce apare: cauzele frecvente

1Cădere ocazională fără reîncercare

Greșit
JSON
HTTP Request → Settings: Retry On Fail dezactivat
Corect
JSON
HTTP Request → Settings: Retry On Fail, Max Tries 3, Wait Between Tries 5000

O a doua încercare, după câteva secunde, prinde serverul disponibil.

2Operație lentă cu timeout implicit

Greșit
JSON
GET /export?an=2025 (durează 90 s)
Corect
JSON
Options → Timeout: 120000, sau cere exportul pe luni

Fie dai serverului timp, fie îi ceri mai puțin de lucru per cerere.

3Server inaccesibil din rețeaua n8n

Greșit
JSON
http://10.0.0.15/api   (n8n Cloud)
Corect
JSON
Adresă publică securizată sau n8n self-hosted în aceeași rețea

Un IP privat nu e accesibil din internet; cererea nu primește niciodată răspuns.

Repară tu

Repară eroarea, direct în pagină

Nodul Export cheamă serviciul de rapoarte https://api.raport.ro/export, care nu răspunde la primele două încercări din fiecare rulare (în n8n real ar apărea „The connection timed out”; în simulator, eșecurile apar ca 503). Activează Retry On Fail cu Max Tries 3 și rulează: execuția trebuie să reușească.

Indiciu

Urmează sugestia din mesaj: opțiunea e în Settings.

Alte forme ale mesajului

  • ETIMEDOUT
  • timeout of 300000ms exceeded
  • ESOCKETTIMEDOUT
  • The connection was aborted, perhaps the server is offline

Cum o eviți pe viitor

  • Activează Retry On Fail pe nodurile care cheamă servicii externe.
  • Setează un Timeout realist în Options, potrivit operației.
  • Împarte cererile mari în cereri mai mici (paginare, intervale de date).
  • Verifică devreme dacă serverul e accesibil din rețeaua n8n.

Întrebări frecvente

Care e timeout-ul implicit?

Depinde de nod și versiune; HTTP Request are opțiunea Timeout în Options, unde îl setezi explicit în milisecunde. Separat, instanța poate avea o limită de timp pentru toată execuția.

Retry e sigur la cereri POST?

Nu întotdeauna: dacă serverul a procesat cererea, dar răspunsul s-a pierdut, retry-ul o poate dubla (o comandă creată de două ori). Folosește chei de idempotență acolo unde API-ul le suportă.

Erori înrudite

← Toate erorile n8n

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ță n8n de la zero, cu exerciții la fiecare lecție

Curs Automatizări AI cu n8n: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.