5. Ciclo de Vida de una Petición: Middlewares, Guards, Interceptors, Pipes y Filters
Domina el orden exacto de ejecución por el que atraviesa cada petición HTTP en NestJS y cuándo utilizar cada bloque arquitectónico.
La Tubería de Ejecución de NestJS (Request Lifecycle)
Una de las preguntas más frecuentes en entrevistas técnicas y en arquitectura con NestJS es: "¿En qué orden se ejecutan los Middlewares, Guards, Interceptors, Pipes y Exception Filters?". Comprender este flujo te permite colocar cada regla en la capa exacta que le corresponde.
Diagrama 5.1: Secuencia exacta del Request Lifecycle en NestJS: Middleware → Guard → Interceptor → Pipe → Controller/Service → Exception Filter.
¿Cuándo usar cada componente?
| Orden | Componente | Responsabilidad Exclusiva |
|---|---|---|
| 1º | Middleware | Operaciones de bajo nivel sobre req/res antes de conocer el handler destino (CORS, compresión gzip, Helmet, cookies). |
| 2º | Guards | Autenticación y Autorización: decide si la petición tiene permiso para continuar (canActivate(): boolean). Tiene acceso a los metadatos del controlador vía ExecutionContext. |
| 3º | Interceptors (Pre) | Lógica transversal antes y después del método usando flujos RxJS (medir tiempos de ejecución, caché, transformación de salida). |
| 4º | Pipes | Validación y Transformación de argumentos: se ejecuta justo antes de entrar al método del controlador sobre cada parámetro (@Body(), @Param()). |
| 5º | Controller & Service | Ejecución de la lógica de negocio con los datos ya autenticados, autorizados y validados. |
| 6º | Exception Filters | Captura cualquier error lanzado en los pasos anteriores y lo formatea en una respuesta HTTP JSON estandarizada. |
⚡ Implementación de un Middleware de Auditoría HTTP en NestJS
Registro de un NestMiddleware en AppModule para auditar método, URL, IP y tiempo de respuesta:
import { Injectable, NestMiddleware, Logger } from '@nestjs/common';
import { Request, Response, NextFunction } from 'express';
@Injectable()
export class LoggerMiddleware implements NestMiddleware {
private readonly logger = new Logger('HTTP');
use(req: Request, res: Response, next: NextFunction): void {
const { method, originalUrl, ip } = req;
const inicio = Date.now();
res.on('finish', () => {
const { statusCode } = res;
const duracion = Date.now() - inicio;
this.logger.log(`${method} ${originalUrl} ${statusCode} - ${duracion}ms [${ip}]`);
});
// Continúa hacia la capa de Guards -> Interceptors -> Pipes -> Controller
next();
}
}
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Cuál es el orden exacto de ejecución por el que pasa una petición HTTP entrante en NestJS antes de llegar al método del controlador?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar NestJS Framework Profesional y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.