...
Eroare Node.js · Fișiere și căi: fs și path

Error: EBADF: bad file descriptor, write

Pe scurt

Încerci să scrii (sau să citești) printr-un descriptor de fișier care a fost deja închis. De obicei fs.closeSync(fd) e pus în buclă sau înainte de ultima scriere. Închide fișierul o singură dată, după ce ai terminat toate operațiile, ideal într-un finally.

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

Ce înseamnă

EBADF vine de la sistemul de operare și înseamnă „bad file descriptor”: numărul primit nu mai corespunde unui fișier deschis de proces. Partea de după virgulă spune operația care a eșuat: write, read, close, fstat.

Descriptorul e valid de la fs.openSync (sau fs.open) până la fs.closeSync. După închidere, același număr nu mai înseamnă nimic, sau, mai rău, poate fi refolosit de sistem pentru alt fișier deschis între timp. De aceea apare EBADF la a doua iterație a unei bucle în care ai pus closeSync din greșeală, sau la close apelat de două ori.

În codul asincron, cauza tipică e ordinea: închizi fișierul imediat după ce pornești o scriere cu callback, iar scrierea rulează abia după închidere. Caută în stivă linia cu operația din mesaj și urmărește unde se închide descriptorul.

De ce apare: cauzele frecvente

1closeSync în interiorul buclei

Greșit
JavaScript
for (const p of produse) {
  fs.writeSync(fd, `${p.nume},${p.pret}\n`);
  fs.closeSync(fd);
}
Corect
JavaScript
for (const p of produse) {
  fs.writeSync(fd, `${p.nume},${p.pret}\n`);
}
fs.closeSync(fd);

Fișierul se închide după prima linie, iar a doua scriere folosește un descriptor închis. Închiderea trebuie făcută o singură dată, după buclă.

2Închidere înainte să termine scrierea asincronă

Greșit
JavaScript
fs.write(fd, text, () => {});
fs.closeSync(fd);
Corect
JavaScript
fs.write(fd, text, (err) => {
  fs.close(fd, () => {});
});

Callback-ul lui fs.write rulează mai târziu; închiderea trebuie mutată acolo, după ce scrierea s-a terminat.

3Închidere dublă

Greșit
JavaScript
try {
  fs.writeSync(fd, text);
  fs.closeSync(fd);
} finally {
  fs.closeSync(fd);
}
Corect
JavaScript
try {
  fs.writeSync(fd, text);
} finally {
  fs.closeSync(fd);
}

finally rulează oricum, deci închiderea din try e în plus și a doua dă EBADF: bad file descriptor, close.

Repară tu

Repară eroarea, direct în pagină

Programul exportă produsele într-un CSV și dă Error: EBADF: bad file descriptor, write după primul produs. Mută închiderea fișierului în locul potrivit, ca toate produsele să fie scrise și programul să afișeze conținutul fișierului export.csv.

Codul care dă eroarea
JavaScript
const fs = require("fs");

const produse = [
  { nume: "Cafea", pret: 42 },
  { nume: "Ceai", pret: 18 },
  { nume: "Cană", pret: 35 },
];

const fd = fs.openSync("export.csv", "w");
fs.writeSync(fd, "produs,pret\n");
for (const p of produse) {
  fs.writeSync(fd, `${p.nume},${p.pret}\n`);
  fs.closeSync(fd);
}

console.log(fs.readFileSync("export.csv", "utf8").trim());
După reparație, programul afișează
produs,pret
Cafea,42
Ceai,18
Cană,35
Indiciu

fs.closeSync(fd) trebuie apelat o singură dată, după ce bucla a scris toate liniile.

Alte forme ale mesajului

  • Error: EBADF: bad file descriptor, close
  • Error: EBADF: bad file descriptor, read
  • Error: EBADF: bad file descriptor, fstat
  • [Error: EBADF: bad file descriptor, write] { errno: -9, code: 'EBADF', syscall: 'write' }

Cum o eviți pe viitor

  • Deschide și închide descriptorul în aceeași funcție, cu închiderea în finally.
  • Pentru majoritatea cazurilor, folosește funcțiile care primesc calea (writeFileSync, appendFileSync) sau un createWriteStream, care gestionează singure descriptorul.
  • După closeSync, nu mai folosi variabila; poți chiar s-o pui pe null ca să prinzi greșelile devreme.

Întrebări frecvente

De ce prima scriere merge și a doua nu?

Prima scriere are loc cât fișierul e încă deschis. Imediat după ea, descriptorul e închis, iar fiecare scriere de după dă EBADF.

Poate EBADF să apară fără să închid eu nimic?

Da, dacă două părți ale programului folosesc același descriptor și una îl închide, sau dacă un pachet închide un descriptor primit de la tine. Regula de bază: cine deschide, acela închide.

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.