Internal Server Error
Codul unei rute a aruncat o eroare netratată, iar Express a răspuns cu 500 și pagina „Internal Server Error”. Cauza reală e în consola serverului, cu stiva de apeluri. Repară eroarea de acolo (de obicei o valoare lipsă) și răspunde explicit cu 400 sau 404 pentru situațiile așteptate.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
500 Internal Server Error nu e o eroare în sine, ci răspunsul generic al serverului când ceva a mers prost în codul lui. În Express, orice excepție aruncată într-o rută sau middleware (și, din Express 5, orice promisiune respinsă într-un handler async) ajunge la handler-ul de erori implicit, care:
- scrie în consola serverului eroarea completă, cu stiva de apeluri (de exemplu
TypeError: Cannot read properties of undefined (reading 'nume')și linia); - trimite clientului statusul 500 și o pagină HTML cu textul
Internal Server Error, fără detalii, ca să nu dezvăluie cod.
Deci primul pas e mereu să te uiți în terminalul în care rulează serverul, nu în browser. Cele mai dese cauze: o resursă care nu există (find întoarce undefined), date lipsă din cerere, o eroare de la baza de date, un bug de scriere.
De ce apare: cauzele frecvente
1Resursă inexistentă netratată
app.get("/api/produse/:id", (req, res) => {
const p = produse.find((x) => x.id === Number(req.params.id));
res.json({ nume: p.nume });
});app.get("/api/produse/:id", (req, res) => {
const p = produse.find((x) => x.id === Number(req.params.id));
if (!p) return res.status(404).json({ eroare: "Produs negăsit" });
res.json({ nume: p.nume });
});Un id inexistent e o situație normală, nu o eroare de server: îi răspunzi cu 404.
2Date invalide în cerere
app.post("/api/comenzi", (req, res) => {
const total = req.body.produse.reduce((s, p) => s + p.pret, 0);
res.json({ total });
});app.post("/api/comenzi", (req, res) => {
if (!Array.isArray(req.body?.produse)) {
return res.status(400).json({ eroare: "Lipsește lista de produse" });
}
const total = req.body.produse.reduce((s, p) => s + p.pret, 0);
res.json({ total });
});Datele trimise de client se validează; pentru date greșite răspunzi cu 400, nu cu 500.
3Lipsește un handler de erori propriu
app.listen(3000);app.use((err, req, res, next) => {
console.error(err);
res.status(500).json({ eroare: "A apărut o eroare. Încearcă din nou." });
});
app.listen(3000);Un handler de erori cu 4 parametri, pus după rute, răspunde în format JSON și loghează eroarea într-un singur loc.
Repară eroarea, direct în pagină
Ruta /api/produse/:id presupune că produsul există mereu, așa că pentru /api/produse/9 aruncă o eroare, iar clientul primește 500 Internal Server Error. Răspunde cu 404 și { eroare: "Produs negăsit" } când produsul nu există, ca testul să afișeze ambele răspunsuri.
const express = require("express");
const app = express();
const produse = [{ id: 1, nume: "Cafea", pret: 42 }];
app.get("/api/produse/:id", (req, res) => {
const produs = produse.find((p) => p.id === Number(req.params.id));
res.json({ nume: produs.nume.toUpperCase(), pret: produs.pret });
});
const server = app.listen(3000, async () => {
for (const id of [1, 9]) {
const r = await fetch(`http://localhost:3000/api/produse/${id}`);
const text = await r.text();
console.log(`${id} -> ${r.status} ${r.status === 500 ? "Internal Server Error" : text}`);
if (r.status === 500) process.exitCode = 1;
}
server.close();
});1 -> 200 {"nume":"CAFEA","pret":42}
9 -> 404 {"eroare":"Produs negăsit"}Indiciu
După find, verifică if (!produs) return res.status(404).json(...).
Reparația
const express = require("express");
const app = express();
const produse = [{ id: 1, nume: "Cafea", pret: 42 }];
app.get("/api/produse/:id", (req, res) => {
const produs = produse.find((p) => p.id === Number(req.params.id));
if (!produs) return res.status(404).json({ eroare: "Produs negăsit" });
res.json({ nume: produs.nume.toUpperCase(), pret: produs.pret });
});
const server = app.listen(3000, async () => {
for (const id of [1, 9]) {
const r = await fetch(`http://localhost:3000/api/produse/${id}`);
const text = await r.text();
console.log(`${id} -> ${r.status} ${r.status === 500 ? "Internal Server Error" : text}`);
if (r.status === 500) process.exitCode = 1;
}
server.close();
});De ce merge
Pentru id-ul 9, find întoarce undefined, iar produs.nume aruncă TypeError. Express prinde excepția, o scrie în consola serverului și trimite clientului doar 500 cu „Internal Server Error”. Cu verificarea if (!produs), cazul lipsă devine un răspuns 404 explicit și util pentru client, iar serverul nu mai are nicio eroare de raportat.
Alte forme ale mesajului
500 Internal Server ErrorError: Request failed with status code 500GET http://localhost:3000/api/produse/9 500 (Internal Server Error)
Cum o eviți pe viitor
- Tratează explicit situațiile așteptate: 404 pentru ce nu există, 400 pentru date invalide.
- Adaugă un handler de erori central
(err, req, res, next)după toate rutele. - Când vezi 500 în browser sau în Postman, citește consola serverului: acolo e mesajul real.
- Scrie teste și pentru cererile greșite (id inexistent, corp gol), nu doar pentru cele corecte.
Întrebări frecvente
De ce nu văd mesajul erorii în browser?
Din motive de securitate, Express nu trimite detaliile erorii clientului. Le vezi în terminalul în care rulează serverul (sau în log-urile serverului, în producție).
Express 4 nu prindea erorile din funcțiile async. Acum le prinde?
Da, Express 5 trimite automat la handler-ul de erori și promisiunile respinse din handler-ele async. În Express 4 trebuia try/catch cu next(err), altfel cererea rămânea fără răspuns.
Erori înrudite
TypeError: res.status is not a function Variabila res nu e obiectul răspuns Express: de obicei parametrii handler-ului sunt inversați ((res, req) în loc de (req, res)), handler-ul de erori are doar 3 parametri în loc de 4, sau folosești modulul http simplu, unde res nu are status() și json(). Verifică ordinea: (req, res, next) și (err, req, res, next). 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(...). 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.
