...
Eroare Node.js · Asincron: callback-uri, promisiuni și timere

TimeoutOverflowWarning: 2592000000 does not fit into a 32-bit signed integer. Timeout duration was set to 1.

Pe scurt

setTimeout și setInterval acceptă cel mult 2147483647 ms (aproximativ 24,8 zile). Peste această valoare, Node afișează warning-ul și rulează callback-ul după 1 ms, adică imediat. Pentru termene lungi, împarte așteptarea în bucăți mai mici sau salvează termenul și verifică-l periodic.

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

Ce înseamnă

Timerele din Node (ca și cele din browser) păstrează întârzierea într-un întreg pe 32 de biți cu semn, deci valoarea maximă e 2147483647 ms, puțin peste 24 de zile și 20 de ore. Dacă dai mai mult (de exemplu 30 de zile = 2592000000 ms), Node nu aruncă eroare: afișează TimeoutOverflowWarning și setează întârzierea la 1 ms.

Rezultatul e un bug greu de observat: un memento programat „peste o lună” pleacă imediat, un job de curățenie rulează în buclă, o sesiune expiră pe loc. Mesajul spune valoarea primită și ce a făcut Node cu ea (Timeout duration was set to 1.).

Warning-ul apare doar o dată per valoare, pe stderr, iar într-un server pornit cu PM2 sau Docker se pierde ușor în loguri. Același lucru se întâmplă și cu setInterval, și cu setTimeout din timers/promises.

De ce apare: cauzele frecvente

1Memento programat pe mai mult de 24 de zile

Greșit
JavaScript
const ZI = 24 * 60 * 60 * 1000;
setTimeout(trimiteMemento, 30 * ZI);
Corect
JavaScript
const MAX = 2 ** 31 - 1;
function asteaptaLung(ms, fn) {
  if (ms > MAX) return setTimeout(() => asteaptaLung(ms - MAX, fn), MAX);
  return setTimeout(fn, ms);
}
asteaptaLung(30 * ZI, trimiteMemento);

Fiecare timer individual rămâne sub limită, iar lanțul lor acoperă toată durata.

2Termene lungi ținute doar în memorie

Greșit
JavaScript
setTimeout(() => expiraAbonament(id), 365 * ZI);
Corect
JavaScript
// salvezi termenul în baza de date
// și verifici o dată pe oră ce a expirat
setInterval(verificaExpirari, 60 * 60 * 1000);

Un proces de server se repornește des; un timer de un an nu supraviețuiește. Termenul salvat și verificat periodic e corect și după restart.

3Unitate greșită (secunde înmulțite încă o dată)

Greșit
JavaScript
const expiraIn = 3600 * 1000; // deja în ms
setTimeout(logout, expiraIn * 1000);
Corect
JavaScript
const expiraIn = 3600 * 1000;
setTimeout(logout, expiraIn);

Înmulțirea dublă cu 1000 transformă o oră în 41 de zile, peste limită. Ține unitatea în numele variabilei (expiraInMs).

Repară tu

Repară eroarea, direct în pagină

Programul programează mementouri, iar cel pentru peste 30 de zile pleacă imediat, cu TimeoutOverflowWarning: 2592000000 does not fit into a 32-bit signed integer. Proiectul oprește programul la orice warning (primele rânduri). Modifică programeaza ca întârzierile mai mari decât limita să fie împărțite în mai mulți timeri, fiecare sub 2 ** 31 - 1 ms.

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 ZI = 24 * 60 * 60 * 1000;
const timere = [];

function programeaza(zile, mesaj) {
  timere.push(setTimeout(() => console.log(`Memento trimis: ${mesaj}`), zile * ZI));
  console.log(`Programat: ${mesaj} (+${zile} zile)`);
}

programeaza(3, "plata facturii");
programeaza(30, "reînnoirea abonamentului");

// demo: oprim programul înainte să treacă zilele
setTimeout(() => {
  timere.forEach(clearTimeout);
  console.log("Demo încheiat");
}, 50);
După reparație, programul afișează
Programat: plata facturii (+3 zile)
Programat: reînnoirea abonamentului (+30 zile)
Demo încheiat
Indiciu

Ține minte cât a mai rămas de așteptat; cât timp e peste limită, pornește un timer de MAX ms care, la final, scade MAX și verifică din nou.

Alte forme ale mesajului

  • (node:4120) TimeoutOverflowWarning: 2592000000 does not fit into a 32-bit signed integer. Timeout duration was set to 1. (Use `node --trace-warnings ...` to show where the warning was created)
  • TimeoutOverflowWarning: 3600000000 does not fit into a 32-bit signed integer. Timeout duration was set to 1.
  • TimeoutOverflowWarning: 31536000000 does not fit into a 32-bit signed integer. Timeout duration was set to 1.
  • TimeoutNegativeWarning: -100 is a negative number. Timeout duration was set to 1.

Cum o eviți pe viitor

  • Nu folosi setTimeout pentru termene de zile sau săptămâni; salvează termenul și verifică-l periodic (sau folosește un programator de joburi).
  • Pune unitatea în numele variabilelor: intarziereMs, expiraInSecunde.
  • Tratează warning-urile ca pe erori în CI (process.on("warning", ...) sau --trace-warnings), ca să le vezi.
  • Dacă ai totuși nevoie de un timer lung, împarte-l în bucăți de cel mult 2 ** 31 - 1 ms.

Întrebări frecvente

De ce limita e 24,8 zile?

2147483647 este cel mai mare număr care încape într-un întreg pe 32 de biți cu semn. În milisecunde, asta înseamnă aproximativ 24 de zile, 20 de ore și 31 de minute.

Și setInterval are aceeași limită?

Da. Un setInterval cu o perioadă prea mare rulează la fiecare milisecundă, ceea ce poate bloca procesul cu apeluri inutile.

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.