Error [ERR_HTTP_HEADERS_SENT]: Cannot set headers after they are sent to the client
Încerci să trimiți al doilea răspuns la aceeași cerere: după res.end, res.send sau res.json ai mai apelat res.json, res.status sau res.setHeader. De obicei lipsește un return după răspunsul de eroare. Scrie return res.status(404).json(...).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Fiecare cerere HTTP primește un singur răspuns: întâi headerele (codul de stare, Content-Type), apoi corpul. După ce ai trimis răspunsul cu res.end(), res.send() sau res.json(), headerele sunt deja plecate la client. Orice încercare ulterioară de a seta headere (res.writeHead, res.setHeader, res.status(...).json(...)) dă ERR_HTTP_HEADERS_SENT.
Cauza clasică: un if care răspunde cu 404 sau 400, dar fără return, așa că funcția merge mai departe și răspunde încă o dată cu 200. Alte cauze: răspuns trimis și în try, și în catch; un middleware care trimite răspuns și apoi apelează next(); un răspuns trimis într-o buclă sau într-un callback apelat de două ori.
În Express eroarea e prinsă și afișată în consolă, iar serverul continuă; cu modulul http simplu, excepția din handler oprește tot serverul. Stiva de apeluri îți arată linia cu al doilea răspuns.
De ce apare: cauzele frecvente
1Lipsește return după răspunsul de eroare
app.get("/produse/:id", (req, res) => {
const p = gaseste(req.params.id);
if (!p) res.status(404).json({ eroare: "Negăsit" });
res.json(p);
});app.get("/produse/:id", (req, res) => {
const p = gaseste(req.params.id);
if (!p) return res.status(404).json({ eroare: "Negăsit" });
res.json(p);
});return oprește funcția după primul răspuns, deci al doilea nu mai e trimis.
2Răspuns în try și în catch
try {
res.json(await salveaza(date));
res.json({ ok: true });
} catch (err) {
res.status(500).json({ eroare: err.message });
}try {
const rezultat = await salveaza(date);
res.json(rezultat);
} catch (err) {
res.status(500).json({ eroare: err.message });
}Pe fiecare drum prin cod trebuie să existe exact un răspuns.
3Middleware care răspunde și apelează next()
function auth(req, res, next) {
if (!req.headers.authorization) res.status(401).end();
next();
}function auth(req, res, next) {
if (!req.headers.authorization) return res.status(401).end();
next();
}După next() ruta trimite și ea un răspuns; middleware-ul trebuie să aleagă: fie răspunde, fie dă mai departe.
Repară eroarea, direct în pagină
Serverul răspunde cu 404 pentru produsele care nu există, dar după răspunsul de eroare continuă și încearcă să trimită și răspunsul de succes, așa că a doua cerere oprește serverul cu Error [ERR_HTTP_HEADERS_SENT]: Cannot set headers after they are sent to the client. Oprește funcția după răspunsul 404, ca testul să afișeze ambele răspunsuri.
const http = require("http");
const produse = [{ id: 1, nume: "Cafea", pret: 42 }];
function trimiteJson(res, cod, date) {
res.writeHead(cod, { "Content-Type": "application/json" });
res.end(JSON.stringify(date));
}
const server = http.createServer((req, res) => {
const produs = produse.find((p) => req.url === `/produse/${p.id}`);
if (!produs) {
trimiteJson(res, 404, { eroare: "Produs negăsit" });
}
trimiteJson(res, 200, produs);
});
server.listen(3000, async () => {
for (const url of ["/produse/1", "/produse/9"]) {
const r = await fetch(`http://localhost:3000${url}`);
console.log(`${url} -> ${r.status} ${await r.text()}`);
}
server.close();
});/produse/1 -> 200 {"id":1,"nume":"Cafea","pret":42}
/produse/9 -> 404 {"eroare":"Produs negăsit"}Indiciu
Pune return în fața apelului care trimite răspunsul 404.
Reparația
const http = require("http");
const produse = [{ id: 1, nume: "Cafea", pret: 42 }];
function trimiteJson(res, cod, date) {
res.writeHead(cod, { "Content-Type": "application/json" });
res.end(JSON.stringify(date));
}
const server = http.createServer((req, res) => {
const produs = produse.find((p) => req.url === `/produse/${p.id}`);
if (!produs) {
return trimiteJson(res, 404, { eroare: "Produs negăsit" });
}
trimiteJson(res, 200, produs);
});
server.listen(3000, async () => {
for (const url of ["/produse/1", "/produse/9"]) {
const r = await fetch(`http://localhost:3000${url}`);
console.log(`${url} -> ${r.status} ${await r.text()}`);
}
server.close();
});De ce merge
Pentru /produse/9, if-ul trimite răspunsul 404, dar funcția nu se oprește și ajunge la trimiteJson(res, 200, ...), care încearcă să scrie din nou headerele cu writeHead. Headerele răspunsului au plecat deja, de aceea Node aruncă ERR_HTTP_HEADERS_SENT. Cu return, handler-ul iese imediat după primul răspuns, deci fiecare cerere primește exact unul. Același tipar (return res.status(404).json(...)) îl folosești și în Express.
Alte forme ale mesajului
Error: Cannot set headers after they are sent to the clientError [ERR_HTTP_HEADERS_SENT]: Cannot set headers after they are sent to the client at ServerResponse.setHeader (node:_http_outgoing:659:11)Error [ERR_HTTP_HEADERS_SENT]: Cannot write headers after they are sent to the client
Cum o eviți pe viitor
- Scrie mereu
return res....când răspunzi din interiorul unuiif. - Structurează handler-ele cu ieșiri timpurii: verificările și erorile întâi, răspunsul de succes la final.
- Într-un middleware, ori trimiți răspunsul, ori apelezi
next(), niciodată ambele. - Verifică
res.headersSentdoar ca plasă de siguranță în handler-ul de erori.
Întrebări frecvente
De ce clientul primește totuși un răspuns corect?
Primul răspuns ajunge normal la client. Eroarea apare abia la a doua încercare, pe server, de aceea o vezi în consola serverului, nu în browser.
Ce face res.headersSent?
E true după ce headerele au fost trimise. Handler-ele de erori îl folosesc ca să nu încerce să răspundă la o cerere care are deja răspuns.
Erori înrudite
Error [ERR_STREAM_WRITE_AFTER_END]: write after end Ai scris într-un stream (fișier sau răspuns HTTP) după ce l-ai închis cu end(). După end() nu mai poți scrie. Scrie toate datele întâi și apelează end() o singură dată, la final; ca să faci ceva după scriere, ascultă evenimentul 'finish'. TypeError [ERR_INVALID_ARG_TYPE]: The "chunk" argument must be of type string or an instance of Buffer or Uint8Array. Received type number (235) Ai dat lui res.write sau res.end (sau unui stream) un număr, un obiect ori un tablou, dar acceptă doar text sau Buffer. Transformă valoarea: res.end(String(total)) pentru numere, res.end(JSON.stringify(date)) pentru obiecte; în Express folosește res.json(date). Cannot GET /api/produs Express nu are nicio rută care să se potrivească cu metoda și calea cererii, așa că răspunde 404 cu Cannot GET /cale. Verifică litera cu literă calea din client și din app.get, metoda (GET vs POST), prefixul din app.use("/api", router) și ordinea în care sunt înregistrate rutele. Î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.
