Error: listen EADDRINUSE: address already in use :::3000 / 0.0.0.0:3000 – Node.js EADDRINUSE_NET

EADDRINUSE_NET

Il server (Express, Fastify, http.createServer) tenta di aprire una porta TCP (es. 3000 o 8080) che è già occupata da un'altra istanza di Node.js o da un altro servizio in esecuzione sulla macchina; si risolve terminando il processo precedente o cambiando porta.

Cosa significa questo errore?

Il server (Express, Fastify, http.createServer) tenta di aprire una porta TCP (es. 3000 o 8080) che è già occupata da un'altra istanza di Node.js o da un altro servizio in esecuzione sulla macchina; si risolve terminando il processo precedente o cambiando porta.

Messaggio originale

Error: listen EADDRINUSE: address already in use :::3000 / 0.0.0.0:3000

Contesto e parole chiave

Alias

  • listen EADDRINUSE address already in use Node.js

Messaggi alternativi

  • porta di rete già in uso da un altro processo EADDRINUSE

Prodotti

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

Piattaforme

  • Linux
  • macOS
  • Windows

Parole chiave

  • errore-nodejs-eaddrinuse-address-already-in-use
  • javascript-backend
  • node
  • nodejs
  • nodejs.rete.eaddrinuse-address-already-in-use
  • Rete e HTTP/HTTPS

Cause possibili

Causa tecnica per Errore Node.js: listen EADDRINUSE: address already in use (Porta Già Occupata)

Il server (Express, Fastify, http.createServer) tenta di aprire una porta TCP (es. 3000 o 8080) che è già occupata da un'altra istanza di Node.js o da un altro servizio in esecuzione sulla macchina; si risolve terminando il processo precedente o cambiando porta.

molto comune

Diagnosi

Diagnostica di runtime o stack trace per Errore Node.js: listen EADDRINUSE: address already in use (Porta Già Occupata)

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 standard per Errore Node.js: listen EADDRINUSE: address already in use (Porta Già Occupata)

Difficoltà: mediaRischio: basso

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

  1. Ispezionare la riga evidenziata dal codice di errore o stack trace
  2. Aggiornare la sintassi di import/export, il controllo dei socket o la gestione della memoria
  3. Riavviare il processo Node.js o il demone di produzione (PM2/systemd) per verificare la stabilità
terminal
node app.js

Domande frequenti

Come risolvere l'errore Errore Node.js: listen EADDRINUSE: address already in use (Porta Già Occupata) in Node.js?

Il server (Express, Fastify, http.createServer) tenta di aprire una porta TCP (es. 3000 o 8080) che è già occupata da un'altra istanza di Node.js o da un altro servizio in esecuzione sulla macchina; si risolve terminando il processo precedente o cambiando porta.

Approfondimenti

Schede correlate