...
Eroare Node.js · Express

ReferenceError: next is not defined

Pe scurt

Middleware-ul tău apelează next(), dar funcția nu are parametrul next: e declarată (req, res) în loc de (req, res, next). Adaugă al treilea parametru. Express dă next fiecărui middleware, dar doar dacă îl primești în lista de parametri.

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

Ce înseamnă

Un middleware Express e o funcție (req, res, next). next e funcția prin care spui „am terminat, treci la următorul handler”. Nu e o variabilă globală: există doar ca parametru, deci dacă l-ai omis din declarație, apelul next() dă ReferenceError: next is not defined.

Eroarea apare la prima cerere care trece prin middleware, nu la pornirea serverului. Express o prinde și răspunde cu 500 Internal Server Error, iar în consolă vezi stiva cu linia din middleware-ul tău. Clientul vede doar 500, fără motiv.

Situații tipice: un middleware de logare sau de autentificare scris rapid ca (req, res) => { ...; next(); }, un handler mutat dintr-o rută (unde nu avea nevoie de next) într-un app.use, sau un middleware de erori scris cu 3 parametri în loc de 4.

De ce apare: cauzele frecvente

1Parametrul next lipsește

Greșit
JavaScript
function logCereri(req, res) {
  console.log(`${req.method} ${req.url}`);
  next();
}
Corect
JavaScript
function logCereri(req, res, next) {
  console.log(`${req.method} ${req.url}`);
  next();
}

Express trimite next ca al treilea argument; trebuie doar să îl primești în declarație.

2Middleware de erori cu parametrii greșiți

Greșit
JavaScript
app.use((err, req, res) => {
  if (err.status === 404) return res.status(404).json({ eroare: err.message });
  next(err);
});
Corect
JavaScript
app.use((err, req, res, next) => {
  if (err.status === 404) return res.status(404).json({ eroare: err.message });
  next(err);
});

Un middleware de erori are exact 4 parametri; doar așa îl recunoaște Express, iar next e al patrulea.

3next folosit într-o funcție ajutătoare

Greșit
JavaScript
function verificaToken(req) {
  if (!req.headers.authorization) return next(new Error("Fără token"));
}
Corect
JavaScript
function auth(req, res, next) {
  if (!req.headers.authorization) return next(new Error("Fără token"));
  next();
}

next există doar în middleware-ul apelat de Express. O funcție ajutătoare trebuie să-l primească ca parametru sau să întoarcă un rezultat, pe care middleware-ul îl tratează.

Repară tu

Repară eroarea, direct în pagină

Serverul are un middleware care afișează fiecare cerere, dar orice cerere primește 500, iar în consolă apare ReferenceError: next is not defined. Repară middleware-ul logCereri, ca cererea să ajungă la rută și programul să afișeze statusul 200 și lista de produse.

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

const app = express();

function logCereri(req, res) {
  console.log(`${req.method} ${req.url}`);
  next();
}

app.use(logCereri);
app.get("/api/produse", (req, res) => res.json(["Cafea", "Ceai"]));

app.use((err, req, res, next) => {
  console.error(`Eroare: ${err.message}`);
  res.status(500).json({ eroare: "Eroare internă" });
});

const server = app.listen(3000, async () => {
  const r = await fetch("http://localhost:3000/api/produse");
  console.log(`Status: ${r.status}`);
  if (!r.ok) process.exitCode = 1;
  else console.log((await r.json()).join(", "));
  server.close();
});
După reparație, programul afișează
GET /api/produse
Status: 200
Cafea, Ceai
Indiciu

Funcția trebuie să primească next ca al treilea parametru.

Alte forme ale mesajului

  • ReferenceError: next is not defined at logCereri (/app/index.js:5:3) at Layer.handle [as handle_request] (/app/node_modules/express/lib/router/layer.js:95:5)
  • TypeError: next is not a function
  • ReferenceError: req is not defined

Cum o eviți pe viitor

  • Declară toate middleware-urile cu trei parametri, (req, res, next), chiar dacă unele ramuri nu apelează next.
  • Middleware-urile de erori au mereu patru: (err, req, res, next).
  • Testează fiecare middleware nou cu o cerere reală (sau cu supertest), ca să vezi eroarea înainte de producție.

Întrebări frecvente

De ce serverul pornește fără eroare?

Funcția e doar înregistrată la pornire, nu și rulată. next e căutat abia când middleware-ul rulează, adică la prima cerere.

Și TypeError: next is not a function?

Apare când parametrul există, dar nu e funcția lui Express: de obicei ai apelat middleware-ul tu, direct, cu mai puține argumente, sau parametrii unui handler de erori sunt în altă ordine.

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.