...
Eroare Node.js · Server HTTP, fetch și porturi

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

Pe scurt

Portul pe care vrei să pornești serverul e deja ocupat: o altă instanță a aplicației (pornită în alt terminal sau rămasă agățată) sau alt program îl folosește. Oprește procesul vechi (Ctrl+C, sau găsește-l cu lsof -i :3000) ori pornește serverul pe alt port.

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

Ce înseamnă

listen este operația prin care serverul cere sistemului un port. EADDRINUSE („address in use”) înseamnă că sistemul a refuzat, pentru că pe portul acela ascultă deja altcineva. :::3000 e adresa: :: înseamnă „toate interfețele” (IPv6, care include și IPv4), iar 3000 e portul.

Cele mai dese cauze: serverul rulează deja în alt terminal, ai pornit aplicația de două ori (de exemplu cu nodemon și manual), procesul vechi n-a fost oprit corect, sau două servere din același program folosesc același port. Eroarea e emisă pe evenimentul 'error' al serverului; fără ascultător, programul se oprește (de aceea vezi și Emitted 'error' event on Server instance).

Ca să afli cine ocupă portul: pe Linux și macOS lsof -i :3000, pe Windows netstat -ano | findstr :3000.

De ce apare: cauzele frecvente

1Serverul rulează deja în alt terminal

Greșit
JavaScript
# terminalul 1
node server.js
# terminalul 2
node server.js
Corect
JavaScript
# oprește prima instanță cu Ctrl+C, apoi:
node server.js

Un singur proces poate asculta pe un port la un moment dat.

2Proces rămas agățat

Greșit
JavaScript
node server.js
# Error: listen EADDRINUSE :::3000
Corect
JavaScript
lsof -i :3000
kill <PID>
node server.js

lsof îți arată procesul care ține portul, iar kill îl oprește.

3Două servere pe același port

Greșit
JavaScript
api.listen(3000);
admin.listen(3000);
Corect
JavaScript
api.listen(3000);
admin.listen(3001);

Fiecare server are nevoie de portul lui.

4Port fix în cod

Greșit
JavaScript
app.listen(3000);
Corect
JavaScript
const PORT = Number(process.env.PORT) || 3000;
app.listen(PORT, () => console.log(`Pornit pe ${PORT}`));

Cu portul din variabila de mediu îl poți schimba la pornire (PORT=3001 node server.js), iar platformele de găzduire îl setează singure.

Repară tu

Repară eroarea, direct în pagină

Programul pornește două servere, unul pentru API și unul pentru panoul de administrare, dar amândouă încearcă să folosească portul 3000 și al doilea dă Error: listen EADDRINUSE: address already in use :::3000. Mută serverul de administrare pe portul 3001, ca testul de la final să primească răspuns de la ambele.

Codul care dă eroarea
JavaScript
const http = require("http");

const PORT_API = 3000;
const PORT_ADMIN = 3000;

const api = http.createServer((req, res) => res.end("API ok"));
const admin = http.createServer((req, res) => res.end("Admin ok"));

api.listen(PORT_API, () => console.log(`API pe portul ${PORT_API}`));
admin.listen(PORT_ADMIN, () => console.log(`Admin pe portul ${PORT_ADMIN}`));

setTimeout(async () => {
  for (const port of [PORT_API, PORT_ADMIN]) {
    const r = await fetch(`http://localhost:${port}/`);
    console.log(`${port}: ${await r.text()}`);
  }
  api.close();
  admin.close();
}, 50);
După reparație, programul afișează
API pe portul 3000
Admin pe portul 3001
3000: API ok
3001: Admin ok
Indiciu

Schimbă doar valoarea din PORT_ADMIN; testul folosește constantele.

Alte forme ale mesajului

  • Error: listen EADDRINUSE: address already in use 127.0.0.1:3000
  • Error: listen EADDRINUSE: address already in use 0.0.0.0:8080
  • Error: listen EACCES: permission denied 0.0.0.0:80

Cum o eviți pe viitor

  • Oprește serverul cu Ctrl+C înainte să-l pornești din nou; folosește node --watch sau nodemon ca să se repornească singur la modificări.
  • Citește portul din process.env.PORT, cu o valoare implicită.
  • Tratează eroarea: server.on("error", (err) => { if (err.code === "EADDRINUSE") ... }) și afișează un mesaj clar.
  • Închide serverul la final în scripturi și teste, cu server.close().

Întrebări frecvente

Ce înseamnă :::3000?

:: este adresa IPv6 care înseamnă „orice interfață”, iar 3000 e portul. Node ascultă implicit pe toate interfețele, de aceea apare această formă.

Ce e varianta EACCES pe portul 80?

Porturile sub 1024 cer drepturi de administrator pe Linux și macOS. În dezvoltare folosește un port mare (3000, 8080); în producție un proxy (Nginx) ascultă pe 80/443 și trimite cererile la aplicație.

Erori înrudite

← Toate erorile Node.js

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

Curs Node.js: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.