...
Eroare Node.js · Express

Internal Server Error

Pe scurt

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ă

Greșit
JavaScript
app.get("/api/produse/:id", (req, res) => {
  const p = produse.find((x) => x.id === Number(req.params.id));
  res.json({ nume: p.nume });
});
Corect
JavaScript
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

Greșit
JavaScript
app.post("/api/comenzi", (req, res) => {
  const total = req.body.produse.reduce((s, p) => s + p.pret, 0);
  res.json({ total });
});
Corect
JavaScript
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

Greșit
JavaScript
app.listen(3000);
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
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();
});
După reparație, programul afișează
1 -> 200 {"nume":"CAFEA","pret":42}
9 -> 404 {"eroare":"Produs negăsit"}
Indiciu

După find, verifică if (!produs) return res.status(404).json(...).

Alte forme ale mesajului

  • 500 Internal Server Error
  • Error: Request failed with status code 500
  • GET 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

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