El middleware son funciones que se ejecutan en secuencia durante el ciclo de solicitud-respuesta en Express. Cada una recibe (req, res, next) y puede inspeccionar/modificar la solicitud y la respuesta, terminar la respuesta, o llamar a next() para pasar el control al siguiente middleware. Son el núcleo de cómo se estructuran las aplicaciones de Express.
app.use((req, res, next) => {
console.log(`${req.method} ${req.url}`); // hacer algo
next(); // ⬅ pasar el control al siguiente middleware
});
La regla crítica: llamar a next() para continuar la cadena. Olvídalo (y no envíes una respuesta), y la solicitud quedará colgada para siempre.
Request → [logger] → [auth] → [body parser] → [route handler] → Response
next() next() next() res.send()
Cada middleware se ejecuta en orden; cualquiera puede cortocircuitar enviando una respuesta.
// 1. A nivel de aplicación — se ejecuta para todas (o las que coincidan con la ruta) las solicitudes
app.use(express.json()); // integrado: parsear cuerpos JSON
app.use(cors()); // de terceros
// 2. Personalizado — p. ej. autenticación que puede CORTOCIRCUITAR
function requireAuth(req, res, next) {
if (!req.headers.authorization) {
return res.status(401).json({ error: "Unauthorized" }); // DETENER — no llamar a next()
}
req.user = decodeToken(req.headers.authorization); // adjuntar datos para manejadores posteriores
next(); // autorizado → continuar
}
// 3. Específico de ruta
app.get("/profile", requireAuth, (req, res) => res.json(req.user));
El middleware puede cortocircuitar (enviar una respuesta y no llamar a next(), p. ej. bloquear solicitudes no autorizadas) o enriquecer la solicitud (adjuntando req.user para los manejadores posteriores).
// firma especial con 4 parámetros → Express lo trata como un manejador de errores
app.use((err, req, res, next) => {
console.error(err);
res.status(500).json({ error: "Server error" });
});
// se dispara con next(err) o un error lanzado; ubícalo al FINAL
Un manejador de errores tiene cuatro parámetros (err primero). Llegas a él llamando a next(err); debe registrarse al final.
El middleware se ejecuta en el ORDEN en que lo registras. El body parser antes de las rutas que
leen el cuerpo; la autenticación antes de las rutas protegidas; el manejador de errores al final.
El middleware es la columna vertebral arquitectónica de Express (y de frameworks similares) — autenticación, logging, parseo del cuerpo, CORS, validación y manejo de errores son todos middleware.
Entender el contrato (req, res, next) (especialmente que debes llamar a next() o enviar una respuesta), cómo el middleware puede cortocircuitar o enriquecer solicitudes, el manejador de errores de cuatro argumentos, y que el orden importa, es esencial para construir, estructurar y depurar cualquier aplicación de Express.