Какие хуки жизненного цикла предоставляет NestJS?

Question

Accepted Answer

NestJS предоставляет **lifecycle hooks** — методы, которые вы реализуете для выполнения кода в определённые моменты жизненного цикла приложения или провайдера (инициализация и завершение). Они необходимы для настройки (подключение к ресурсам) и очистки (корректное закрытие соединений).

## The main hooks

```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
  }
}
```

## The lifecycle sequence

```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.)
```

## A common use: a Prisma service connecting/disconnecting

```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
  }
}
```

Это стандартный паттерн для ресурсов, требующих явной инициализации/очистки — подключение в `onModuleInit`, освобождение в `onModuleDestroy`.

## Enabling shutdown hooks

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

Хуки завершения работают только если вы вызовете `enableShutdownHooks()` — легко забыть, и тогда очистка никогда не произойдёт.

## Why graceful shutdown matters

```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
```

## Почему это важно

Хуки жизненного цикла важны для корректного управления ресурсами в NestJS приложениях — они предоставляют правильные места для выполнения **инициализации** (открытие подключений к БД/Redis, загрузка данных, регистрация в сервисах) и, что критически, **корректной очистки** при завершении (закрытие соединений, сброс буферов, завершение текущих запросов).

Понимание их необходимо для надёжности в продакшене: **хуки инициализации** (`onModuleInit`, `onApplicationBootstrap`) гарантируют, что настройка происходит в нужный момент, когда зависимости готовы, а **хуки завершения** (`onModuleDestroy`, `onApplicationShutdown`) обеспечивают **graceful shutdown** — что критически важно в современных развёртываниях (контейнеры/оркестраторы постоянно отправляют SIGTERM при развёртываниях и масштабировании, и без корректной очистки вы протекаете соединения и теряете активные запросы, нарушая zero-downtime развёртывания).

Стандартный паттерн подключения в `onModuleInit` и отключения в `onModuleDestroy` (например, для Prisma/сервисов БД) — повседневное знание NestJS, а понимание тонкого требования вызывать `enableShutdownHooks()` (иначе хуки завершения молчаливо не сработают) — это практический, легко упускаемый деталь.

Овладение хуками жизненного цикла — часть создания надёжных, production-ready NestJS сервисов, которые корректно обрабатывают ресурсы и развёртывания.