Rete e HTTP/HTTPS

HeadersTimeoutError: Headers Timeout Error in global fetch / undici client – Node.js UNDICI_HEADERS_TIMEOUT

UNDICI_HEADERS_TIMEOUT

Il client 'fetch()' nativo ha stabilito la connessione ma il server non ha inviato le intestazioni HTTP di risposta entro il timeout prestabilito (default 300 secondi in Undici).

Categoria: Node.jsGruppo: Rete e HTTP/HTTPSConfidenza: altaUltimo aggiornamento: 19-08-2026Letto 1 volta

Cosa significa questo errore?

Il client 'fetch()' nativo ha stabilito la connessione ma il server non ha inviato le intestazioni HTTP di risposta entro il timeout prestabilito (default 300 secondi in Undici).

Messaggio originale

HeadersTimeoutError: Headers Timeout Error in global fetch / undici client

Contesto e parole chiave

Alias

  • HeadersTimeoutError global fetch Node.js undici

Messaggi alternativi

  • timeout ricezione intestazioni HTTP in fetch

Prodotti

  • Node.js Runtime (v18 LTS, v20 LTS, v22 LTS, v24)

Piattaforme

  • Linux
  • macOS
  • Windows

Parole chiave

  • errore-nodejs-undici-headers-timeout-fetch
  • javascript-backend
  • node
  • nodejs
  • nodejs.rete.undici-headers-timeout
  • Rete e HTTP/HTTPS
  • UNDICI_HEADERS_TIMEOUT

Cause possibili

Origine del problema per Errore Node.js: HeadersTimeoutError in global fetch (Undici)

Il client 'fetch()' nativo ha stabilito la connessione ma il server non ha inviato le intestazioni HTTP di risposta entro il timeout prestabilito (default 300 secondi in Undici).

molto comune

Diagnosi

Diagnostica di runtime o stack trace per Errore Node.js: HeadersTimeoutError in global fetch (Undici)

Eseguire Node.js con i flag diagnostici (--trace-warnings --trace-uncaught) per visualizzare l'origine dettagliata dell'eccezione.

Come leggere il risultato. Evidenzia il modulo esatto, la riga e lo stack trace della chiamata asincrona in errore.

terminal
node --trace-warnings --trace-uncaught app.js

Risoluzione

Risoluzione per Errore Node.js: HeadersTimeoutError in global fetch (Undici)

Difficoltà: mediaRischio: basso

Applicare la correzione al codice sorgente Node.js o alla configurazione del package.json / sistema operativo.

  1. Ispezionare la riga evidenziata dal codice di errore o stack trace
  2. Aggiornare la sintassi di import/export, la gestione degli stream o le chiamate di rete
  3. Riavviare il processo Node.js o il demone di produzione (PM2/systemd) per verificare la correzione
terminal
node app.js

Domande frequenti

Come risolvere l'errore Errore Node.js: HeadersTimeoutError in global fetch (Undici) in Node.js?

Il client 'fetch()' nativo ha stabilito la connessione ma il server non ha inviato le intestazioni HTTP di risposta entro il timeout prestabilito (default 300 secondi in Undici).

Approfondimenti

Schede correlate