...
Eroare Node.js · EventEmitter și stream-uri

MaxListenersExceededWarning: Possible EventEmitter memory leak detected. 11 comanda listeners added to [EventEmitter]. MaxListeners is 10. Use emitter.setMaxListeners() to increase limit

Pe scurt

Ai adăugat mai mult de 10 ascultători pentru același eveniment pe același obiect, de obicei pentru că .on() e apelat într-o buclă, la fiecare cerere sau la fiecare apel de funcție. Înregistrează ascultătorul o singură dată, sau scoate-l cu .off() când nu mai e nevoie de el. Mărește limita doar dacă chiar ai nevoie de atâția ascultători.

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

Ce înseamnă

Fiecare EventEmitter are o limită de avertizare de 10 ascultători pe eveniment. Nu e o limită tehnică (al 11-lea ascultător se adaugă normal), ci un semnal că probabil ai o scurgere de memorie: cod care adaugă ascultători mereu și nu îi scoate niciodată.

Mesajul spune evenimentul (comanda), câți ascultători sunt (11), pe ce tip de obiect ([EventEmitter], [Socket], [process], [AbortSignal]) și limita curentă. Pornește aplicația cu node --trace-warnings ca să vezi linia care a adăugat al 11-lea ascultător.

Pe lângă memorie, scurgerea are un efect vizibil: fiecare ascultător în plus rulează la fiecare eveniment, deci aceeași acțiune (un email, o scriere în log) se face de mai multe ori. Cauze tipice: emitter.on(...) în interiorul unei funcții apelate repetat, process.on("exit") într-un modul încărcat de multe ori, socket.on("data") adăugat la fiecare mesaj.

De ce apare: cauzele frecvente

1Ascultător adăugat la fiecare apel de funcție

Greșit
JavaScript
function proceseaza(id) {
  magazin.on("comanda", trimiteConfirmare);
  magazin.emit("comanda", id);
}
Corect
JavaScript
magazin.on("comanda", trimiteConfirmare);

function proceseaza(id) {
  magazin.emit("comanda", id);
}

Ascultătorul se înregistrează o singură dată, la pornire; funcția doar emite evenimentul.

2Ascultător temporar care nu e scos

Greșit
JavaScript
function asteaptaPlata(id) {
  plati.on("confirmata", (p) => { if (p.id === id) livreaza(id); });
}
Corect
JavaScript
function asteaptaPlata(id) {
  const fn = (p) => {
    if (p.id !== id) return;
    plati.off("confirmata", fn);
    livreaza(id);
  };
  plati.on("confirmata", fn);
}

Ascultătorul se scoate singur după ce și-a făcut treaba. Pentru „doar o dată”, fără filtru, există direct plati.once(...).

3Chiar ai nevoie de mulți ascultători

Greșit
JavaScript
for (const modul of module) magistrala.on("start", modul.porneste);
// 25 de module
Corect
JavaScript
magistrala.setMaxListeners(50);
for (const modul of module) magistrala.on("start", modul.porneste);

Dacă numărul e mare din proiectare, nu din greșeală, ridici limita explicit pentru acel obiect. Nu o pune pe 0 (fără limită) la întâmplare.

Repară tu

Repară eroarea, direct în pagină

Programul procesează 11 comenzi și trimite câte o confirmare pentru fiecare, dar afișează MaxListenersExceededWarning: Possible EventEmitter memory leak detected și raportează mult mai multe confirmări decât comenzi. Proiectul oprește programul la orice warning (primele rânduri). Înregistrează ascultătorul o singură dată, ca fiecare comandă să primească exact o confirmare.

Codul care dă eroarea
JavaScript
// Proiectul tratează orice warning ca pe o eroare (ca în CI): îl afișează și oprește cu cod 1.
process.on("warning", (w) => {
  console.error(`${w.code ? `[${w.code}] ` : ""}${w.name}: ${w.message}`);
  process.exitCode = 1;
});

const EventEmitter = require("events");

const magazin = new EventEmitter();
let confirmari = 0;

function trimiteConfirmare(id) {
  confirmari++;
}

function proceseaza(id) {
  magazin.on("comanda", trimiteConfirmare);
  magazin.emit("comanda", id);
}

const comenzi = [101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111];
comenzi.forEach(proceseaza);

console.log(`Comenzi: ${comenzi.length}`);
console.log(`Confirmări trimise: ${confirmari}`);
console.log(`Ascultători „comanda”: ${magazin.listenerCount("comanda")}`);
După reparație, programul afișează
Comenzi: 11
Confirmări trimise: 11
Ascultători „comanda”: 1
Indiciu

Mută magazin.on("comanda", trimiteConfirmare) în afara funcției proceseaza, înainte de buclă.

Alte forme ale mesajului

  • (node:4120) MaxListenersExceededWarning: Possible EventEmitter memory leak detected. 11 exit listeners added to [process]. MaxListeners is 10. Use emitter.setMaxListeners() to increase limit
  • MaxListenersExceededWarning: Possible EventEmitter memory leak detected. 11 error listeners added to [Socket]. MaxListeners is 10. Use emitter.setMaxListeners() to increase limit
  • MaxListenersExceededWarning: Possible EventTarget memory leak detected. 11 abort listeners added to [AbortSignal]. MaxListeners is 10. Use events.setMaxListeners() to increase limit
  • MaxListenersExceededWarning: Possible EventEmitter memory leak detected. 11 close listeners added to [TLSSocket]. MaxListeners is 10. Use emitter.setMaxListeners() to increase limit

Cum o eviți pe viitor

  • Înregistrează ascultătorii o singură dată, la inițializare, nu în funcții apelate repetat.
  • Pentru ascultători temporari folosește once sau scoate-i cu off, păstrând referința la funcție.
  • Verifică în teste emitter.listenerCount("eveniment") după mai multe operații: trebuie să rămână constant.
  • Nu ascunde warning-ul cu setMaxListeners(0); caută întâi locul care adaugă ascultătorii.

Întrebări frecvente

Al 11-lea ascultător mai funcționează?

Da, se adaugă și rulează normal. Warning-ul e doar un avertisment, de aceea problema trece ușor neobservată până când memoria crește sau acțiunile se dublează.

Cum aflu ce cod adaugă ascultătorii?

Pornește cu node --trace-warnings index.js: warning-ul vine cu stiva de apeluri care a adăugat ascultătorul. Poți afișa și emitter.listeners("comanda") ca să vezi funcțiile înregistrate.

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.