...
Eroare Node.js · Server HTTP, fetch și porturi

Error [ERR_HTTP_HEADERS_SENT]: Cannot set headers after they are sent to the client

Pe scurt

Î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

Greșit
JavaScript
app.get("/produse/:id", (req, res) => {
  const p = gaseste(req.params.id);
  if (!p) res.status(404).json({ eroare: "Negăsit" });
  res.json(p);
});
Corect
JavaScript
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

Greșit
JavaScript
try {
  res.json(await salveaza(date));
  res.json({ ok: true });
} catch (err) {
  res.status(500).json({ eroare: err.message });
}
Corect
JavaScript
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()

Greșit
JavaScript
function auth(req, res, next) {
  if (!req.headers.authorization) res.status(401).end();
  next();
}
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
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();
});
După reparație, programul afișează
/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.

Alte forme ale mesajului

  • Error: Cannot set headers after they are sent to the client
  • Error [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 unui if.
  • 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.headersSent doar 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

← 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.