The connection timed out, consider setting the 'Retry on Fail' option in the node settings
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
HTTP Request → Settings: Retry On Fail dezactivatHTTP Request → Settings: Retry On Fail, Max Tries 3, Wait Between Tries 5000O a doua încercare, după câteva secunde, prinde serverul disponibil.
2Operație lentă cu timeout implicit
GET /export?an=2025 (durează 90 s)Options → Timeout: 120000, sau cere exportul pe luniFie dai serverului timp, fie îi ceri mai puțin de lucru per cerere.
3Server inaccesibil din rețeaua n8n
http://10.0.0.15/api (n8n Cloud)Adresă publică securizată sau n8n self-hosted în aceeași rețeaUn IP privat nu e accesibil din internet; cererea nu primește niciodată răspuns.
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.
Reparația
1. Export → Settings → Retry On Fail: activ, Max Tries: 3. 2. Execute workflow: a treia încercare reușește:
{ "fisier": "raport-martie.csv", "randuri": 131 }De ce merge
Serviciul nu răspunde la timp la primele cereri, iar fără reîncercare prima eroare oprește workflow-ul. Cu Retry On Fail și Max Tries 3, n8n repetă cererea automat, iar a treia încercare primește exportul. Pentru un timeout real, ai putea mări și Options → Timeout.
Alte forme ale mesajului
ETIMEDOUTtimeout of 300000ms exceededESOCKETTIMEDOUTThe 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
Service unavailable - try again later or consider setting this node to retry automatically (in the node settings) API-ul a răspuns 503: serviciul e temporar supraîncărcat sau în mentenanță. Nu e o greșeală în workflow; activează în Settings Retry On Fail (de exemplu 3 încercări, cu pauză între ele) ca n8n să încerce din nou automat. connect ECONNREFUSED 127.0.0.1:3000 Adresa a fost găsită, dar nimic nu acceptă conexiuni pe acel port. Cel mai des: folosești localhost din n8n rulat în Docker (localhost e containerul n8n, nu calculatorul tău) sau serviciul țintă e oprit. Folosește adresa reală a serviciului (host.docker.internal, numele serviciului din Docker Compose sau domeniul public). The service is receiving too many requests from you API-ul a răspuns 429 Too Many Requests: workflow-ul trimite prea multe cereri într-un timp scurt (de obicei câte una pentru fiecare item). Trimite mai puține cereri (Execute Once când datele sunt aceleași, loturi cu Batching) sau pune pauze între ele și retry cu așteptare. Î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.
