¿Qué hooks de ciclo de vida proporciona NestJS?

Question

Accepted Answer

NestJS proporciona **hooks de ciclo de vida** — métodos que implementas para ejecutar código en momentos específicos del ciclo de vida de la aplicación o de un proveedor (inicialización y apagado). Son esenciales para la configuración (conectar a recursos) y la limpieza (cerrar conexiones correctamente).

## Los hooks principales

```ts
@Injectable()
export class DatabaseService
  implements OnModuleInit, OnApplicationShutdown {

async onModuleInit() {
    // runs once the host MODULE's dependencies are resolved → do INITIALIZATION
    await this.connect();         // e.g. open a database connection
  }

async onApplicationShutdown(signal: string) {
    // runs when the app is shutting down → do CLEANUP
    await this.disconnect();      // close connections, flush, release resources
  }
}
```

## La secuencia del ciclo de vida

```text
INITIALIZATION (startup):
  onModuleInit()          → after the module's providers are initialized
  onApplicationBootstrap()→ after ALL modules are initialized (whole app ready)

SHUTDOWN (graceful termination):
  onModuleDestroy()         → cleanup as modules are destroyed
  beforeApplicationShutdown() → before shutdown completes
  onApplicationShutdown(signal) → final shutdown (signal = SIGTERM, etc.)
```

## Un caso común: un servicio Prisma conectando/desconectando

```ts
@Injectable()
export class PrismaService extends PrismaClient
  implements OnModuleInit, OnModuleDestroy {

async onModuleInit() {
    await this.$connect();        // connect on startup
  }
  async onModuleDestroy() {
    await this.$disconnect();      // disconnect on shutdown — clean release
  }
}
```

Este es el patrón estándar para recursos que necesitan configuración/desmontaje explícitos — conectar en `onModuleInit`, liberar en `onModuleDestroy`.

## Habilitando shutdown hooks

```ts
// shutdown hooks must be enabled explicitly
const app = await NestFactory.create(AppModule);
app.enableShutdownHooks();        // ❗ required for onApplicationShutdown etc. to fire
```

Los shutdown hooks solo se ejecutan si llamas a `enableShutdownHooks()` — fácil de olvidar, y luego la limpieza nunca ocurre.

## Por qué el apagado graceful es importante

```text
When the app receives SIGTERM (deploy, scale-down, container stop):
  ✗ Without shutdown hooks → connections left open, in-flight work dropped
  ✓ With shutdown hooks → close DB/Redis/queues cleanly, finish work → zero-downtime
```

## Por qué es importante

Los hooks de ciclo de vida son importantes para gestionar recursos correctamente en aplicaciones NestJS — proporcionan los lugares apropiados para realizar **inicialización** (abrir conexiones de base de datos/Redis, cargar datos, registrarse con servicios) y, críticamente, **limpieza graceful** al apagarse (cerrar conexiones, descargar buffers, finalizar trabajo en vuelo).

Entenderlos es esencial para la confiabilidad en producción: los **hooks de inicialización** (`onModuleInit`, `onApplicationBootstrap`) aseguran que la configuración ocurra en el momento correcto una vez que las dependencias estén listas, y los **hooks de apagado** (`onModuleDestroy`, `onApplicationShutdown`) permiten **apagado graceful** — que es vital en despliegues modernos (contenedores/orquestadores envían SIGTERM constantemente durante despliegues y escalado, y sin limpieza adecuada pierdes conexiones y descartas solicitudes activas, rompiendo despliegues sin tiempo de inactividad).

El patrón estándar de conectar en `onModuleInit` y desconectar en `onModuleDestroy` (p. ej. para servicios Prisma/base de datos) es conocimiento cotidiano de NestJS, y saber el requisito sutil de llamar a `enableShutdownHooks()` (o los shutdown hooks nunca se disparan silenciosamente) es un detalle práctico y fácil de pasar por alto.

Dominar los hooks de ciclo de vida es parte de construir servicios NestJS robustos y listos para producción que manejen recursos y despliegues correctamente.