Error: listen EADDRINUSE: address already in use :::3000
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
# terminalul 1
node server.js
# terminalul 2
node server.js# oprește prima instanță cu Ctrl+C, apoi:
node server.jsUn singur proces poate asculta pe un port la un moment dat.
2Proces rămas agățat
node server.js
# Error: listen EADDRINUSE :::3000lsof -i :3000
kill <PID>
node server.jslsof îți arată procesul care ține portul, iar kill îl oprește.
3Două servere pe același port
api.listen(3000);
admin.listen(3000);api.listen(3000);
admin.listen(3001);Fiecare server are nevoie de portul lui.
4Port fix în cod
app.listen(3000);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ă 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.
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);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.
Reparația
const http = require("http");
const PORT_API = 3000;
const PORT_ADMIN = 3001;
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);De ce merge
Un port poate fi ascultat de un singur server odată. Primul listen(3000) ocupă portul, iar al doilea primește de la sistem EADDRINUSE, emis pe evenimentul 'error' al serverului; fără ascultător, programul se oprește. Cu portul 3001, fiecare server are portul lui, iar fetch ajunge la serverul potrivit după numărul portului. În aplicațiile reale ia portul din process.env.PORT, ca să-l poți schimba fără să modifici codul.
Alte forme ale mesajului
Error: listen EADDRINUSE: address already in use 127.0.0.1:3000Error: listen EADDRINUSE: address already in use 0.0.0.0:8080Error: 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 --watchsaunodemonca 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
Error: connect ECONNREFUSED 127.0.0.1:3000 Programul tău încearcă să se conecteze la un server care nu ascultă la adresa și portul acela: serverul nu e pornit, s-a oprit sau folosești alt port. Pornește serverul (sau baza de date) și verifică portul din URL. Cu fetch, eroarea apare ca TypeError: fetch failed, cu ECONNREFUSED în cause. Error [ERR_HTTP_HEADERS_SENT]: Cannot set headers after they are sent to the client Încerci să trimiți al doilea răspuns la aceeași cerere: după res.end, res.send sau res.json ai mai apelat res.json, res.status sau res.setHeader. De obicei lipsește un return după răspunsul de eroare. Scrie return res.status(404).json(...). Error [ERR_UNHANDLED_ERROR]: Unhandled error. ('Senzor deconectat') Un EventEmitter a emis evenimentul 'error' și nu are niciun ascultător pentru el, așa că Node oprește programul. Adaugă emitter.on("error", (err) => {...}) înainte de emit și emite obiecte Error, nu texte. Î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.
