Tema 5 · Request Lifecycle

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 Técnico: Ciclo de Vida de una Petición HTTP en NestJS

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:

src/common/middleware/logger.middleware.ts
Solo lectura
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
1 Pregunta
Pregunta 1
¿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.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.