MaxListenersExceededWarning: Possible EventEmitter memory leak detected. 11 comanda listeners added to [EventEmitter]. MaxListeners is 10. Use emitter.setMaxListeners() to increase limit
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
function proceseaza(id) {
magazin.on("comanda", trimiteConfirmare);
magazin.emit("comanda", id);
}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
function asteaptaPlata(id) {
plati.on("confirmata", (p) => { if (p.id === id) livreaza(id); });
}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
for (const modul of module) magistrala.on("start", modul.porneste);
// 25 de modulemagistrala.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ă 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.
// 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")}`);Comenzi: 11 Confirmări trimise: 11 Ascultători „comanda”: 1
Indiciu
Mută magazin.on("comanda", trimiteConfirmare) în afara funcției proceseaza, înainte de buclă.
Reparația
// 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++;
}
magazin.on("comanda", trimiteConfirmare);
function proceseaza(id) {
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")}`);De ce merge
În varianta greșită, fiecare apel al lui proceseaza adăuga încă o dată trimiteConfirmare ca ascultător. La a 11-a comandă erau 11 ascultători (de aici warning-ul), iar fiecare emit îi rula pe toți, deci confirmările se înmulțeau: 66 în loc de 11. Înregistrat o singură dată, la pornire, ascultătorul rulează exact o dată pentru fiecare comandă, iar numărul de ascultători rămâne 1 oricât de multe comenzi procesezi.
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 limitMaxListenersExceededWarning: Possible EventEmitter memory leak detected. 11 error listeners added to [Socket]. MaxListeners is 10. Use emitter.setMaxListeners() to increase limitMaxListenersExceededWarning: Possible EventTarget memory leak detected. 11 abort listeners added to [AbortSignal]. MaxListeners is 10. Use events.setMaxListeners() to increase limitMaxListenersExceededWarning: 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
oncesau scoate-i cuoff, 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
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. TypeError [ERR_INVALID_ARG_TYPE]: The "listener" argument must be of type function. Received undefined Ai dat lui on, once sau addListener rezultatul unei funcții în loc de funcția însăși, de obicei emitter.on("comanda", trimiteEmail()). Scoate parantezele: emitter.on("comanda", trimiteEmail), sau folosește o funcție săgeată. TypeError: this.emit is not a function În interiorul unui callback scris cu function, this nu mai este obiectul tău EventEmitter, ci altceva (un Timeout, un stream, undefined). Folosește o funcție săgeată, care păstrează this din metoda clasei, sau salvează obiectul într-o variabilă înainte de callback. Î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.
