RangeError [ERR_BUFFER_OUT_OF_BOUNDS]: Attempt to access memory outside buffer bounds
Încerci să citești sau să scrii un câmp mai mare decât tot bufferul, de exemplu 4 octeți (readInt32BE) dintr-un buffer de 2. Verifică dimensiunea câmpului din format (16 sau 32 de biți?) și lungimea bufferului, de obicei rezultatul unui slice sau subarray.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul apare când operația nu are cum să încapă, indiferent de poziție: bufferul are mai puțini octeți decât câmpul cerut. readUInt32BE, readInt32LE, readFloatBE au nevoie de 4 octeți, readDoubleBE și readBigInt64LE de 8, readUInt16BE de 2. Dacă bufferul (sau bucata obținută cu subarray/slice) e mai scurt, nu există niciun offset valid.
Diferența față de The value of "offset" is out of range: acolo bufferul e destul de mare, dar ai cerut o poziție greșită; aici bufferul e prea mic pentru tipul de câmp.
Cauze frecvente: ai ales funcția pentru alt tip de număr (32 de biți în loc de 16), ai tăiat bufferul prea scurt, ai primit un pachet incomplet sau un fișier gol. Stiva arată linia cu read.../write...; afișează acolo buf.length ca să vezi câți octeți ai de fapt.
De ce apare: cauzele frecvente
1Funcție pentru alt număr de octeți
// temperatura e pe 2 octeți
const temp = pachet.subarray(2).readInt32BE(0);const temp = pachet.subarray(2).readInt16BE(0);readInt32BE citește 4 octeți, dar bucata are doar 2. readInt16BE citește exact cât are câmpul.
2Buffer gol sau incomplet
const date = fs.readFileSync("senzor.bin");
const valoare = date.readFloatLE(0);const date = fs.readFileSync("senzor.bin");
if (date.length < 4) throw new Error("Fișierul senzorului e incomplet");
const valoare = date.readFloatLE(0);Un fișier gol (de exemplu încă nescris) are lungimea 0. Verificarea transformă eroarea criptică într-un mesaj clar.
3Scriere într-un buffer alocat prea mic
const buf = Buffer.alloc(2);
buf.writeUInt32BE(1042);const buf = Buffer.alloc(4);
buf.writeUInt32BE(1042);Alocă bufferul cu dimensiunea tuturor câmpurilor pe care le scrii.
Repară eroarea, direct în pagină
Fiecare pachet de la senzori are 2 octeți pentru id și 2 octeți pentru temperatură (în zecimi de grad, cu semn). Programul dă RangeError [ERR_BUFFER_OUT_OF_BOUNDS]: Attempt to access memory outside buffer bounds la citirea temperaturii. Folosește funcția potrivită pentru un număr cu semn pe 2 octeți, ca programul să afișeze temperatura fiecărui senzor.
const pachete = [
Buffer.from([0x00, 0x07, 0x00, 0xeb]),
Buffer.from([0x00, 0x08, 0xff, 0xec]),
];
try {
for (const p of pachete) {
const id = p.readUInt16BE(0);
const temp = p.subarray(2).readInt32BE(0) / 10;
console.log(`Senzor ${id}: ${temp}°C`);
}
} catch (err) {
console.error(`${err.code}: ${err.message}`);
process.exitCode = 1;
}Senzor 7: 23.5°C Senzor 8: -2°C
Indiciu
Pentru 16 biți cu semn, big-endian, funcția este readInt16BE.
Reparația
const pachete = [
Buffer.from([0x00, 0x07, 0x00, 0xeb]),
Buffer.from([0x00, 0x08, 0xff, 0xec]),
];
try {
for (const p of pachete) {
const id = p.readUInt16BE(0);
const temp = p.subarray(2).readInt16BE(0) / 10;
console.log(`Senzor ${id}: ${temp}°C`);
}
} catch (err) {
console.error(`${err.code}: ${err.message}`);
process.exitCode = 1;
}De ce merge
p.subarray(2) are doar 2 octeți, iar readInt32BE cere 4, deci operația nu încape nicăieri în buffer. Temperatura e un număr pe 16 biți cu semn, pe care îl citește readInt16BE: 0x00eb înseamnă 235 (23,5 °C), iar 0xffec e -20 în complement față de 2 (-2 °C). Funcția potrivită contează și pentru semn: readUInt16BE ar fi dat 65516 pentru al doilea senzor.
Alte forme ale mesajului
RangeError [ERR_BUFFER_OUT_OF_BOUNDS]: Attempt to access memory outside buffer bounds at boundsError (node:internal/buffer)RangeError [ERR_BUFFER_OUT_OF_BOUNDS]: "length" is outside of buffer boundsRangeError [ERR_BUFFER_OUT_OF_BOUNDS]: "offset" is outside of buffer bounds
Cum o eviți pe viitor
- Notează formatul binar cu dimensiunea fiecărui câmp și folosește funcția potrivită (
Int16,Int32,Float,Double). - Verifică
buf.lengthînainte de citire, mai ales pentru date din rețea sau din fișiere. - Pentru formate complexe, scrie o singură funcție de parsare, testată cu exemple scurte și incomplete.
Întrebări frecvente
Care e diferența dintre subarray și slice?
La Buffer, amândouă întorc o vedere peste aceeași memorie, fără copiere (slice e depreciat în favoarea lui subarray). Lungimea rezultatului e cea a bucății, deci citirile se fac relativ la ea, începând de la 0.
De ce mesajul nu spune lungimea bufferului?
Eroarea vine dintr-o verificare internă rapidă. Afișează tu buf.length și dimensiunea câmpului ca să vezi diferența.
Erori înrudite
RangeError [ERR_OUT_OF_RANGE]: The value of "offset" is out of range. It must be >= 0 and <= 3. Received 4 Citești sau scrii într-un Buffer la o poziție (offset) care depășește lungimea lui. Mesajul îți dă intervalul permis și valoarea primită. De obicei e o buclă cu i <= buf.length în loc de i < buf.length, sau un câmp citit dintr-un pachet mai scurt decât crezi. RangeError [ERR_OUT_OF_RANGE]: The value of "value" is out of range. It must be >= 0 and <= 255. Received 300 Numărul pe care îl scrii nu încape în tipul ales: writeUInt8 acceptă 0-255, writeInt8 -128..127, writeUInt16BE 0-65535. Alege un tip mai mare (writeUInt16BE, writeUInt32BE) și alocă bufferul cu octeții necesari, sau validează valoarea înainte. TypeError [ERR_INVALID_ARG_TYPE]: The "string" argument must be of type string or an instance of Buffer or ArrayBuffer. Received undefined Buffer.byteLength() a primit undefined în loc de text, cel mai des pentru că JSON.stringify(undefined) întoarce undefined, nu un text. Asta se întâmplă când datele trimise lipsesc (find() nu a găsit nimic). Tratează lipsa datelor înainte, de exemplu cu un răspuns 404. Î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.
