Mitä lifecycle-hookkeja NestJS tarjoaa?

Question

Accepted Answer

NestJS tarjoaa **lifecycle-hookit** — metodeita, joita toteutat suorittaaksesi koodia sovelluksen tai providerin elinkaaren (alustaminen ja sammutus) tietyissä vaiheissa. Ne ovat välttämättömiä asennukselle (resursseihin yhdistäminen) ja siivoustyölle (yhteyksien sulkeminen kunnollisesti).

## Pääkiikat

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

## Elinkaaren järjestys

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

## Yleinen esimerkki: Prisma-palvelu yhdistämisen ja yhteyksien katkaisu

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

Tämä on vakiokaava resursseille, jotka tarvitsevat nimenomasta asennusta/purkamista — yhdistä `onModuleInit`-vaiheessa, vapauta `onModuleDestroy`-vaiheessa.

## Sammutushookien aktivoiminen

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

Sammutushookit suoritetaan vain, jos kutsut `enableShutdownHooks()`-metodia — helppo unohtaa, jolloin siivoustyö ei koskaan tapahdu.

## Miksi kunnollinen sammutus on tärkeää

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

## Miksi se on tärkeää

Lifecycle-hookit ovat tärkeitä resursseista huolehtimisen kannalta NestJS-sovelluksissa — ne tarjoavat oikeat paikat **alustukselle** (tietokanta-/Redis-yhteyksien avaaminen, tiedon lataaminen, palveluiden rekisteröinti) ja, kriittisesti, **kunnolliselle siivoustyölle** sammutuksessa (yhteyksien sulkeminen, puskurien tyhjentäminen, käynnissä olevien pyyntöjen viimeistely).
\'Niiden ymmärtäminen on olennaista tuotannon luotettavuuden kannalta: **alustushookit** (`onModuleInit`, `onApplicationBootstrap`) varmistavat, että asennus tapahtuu oikeassa vaiheessa, kun riippuvuudet ovat valmiita, ja **sammutushookit** (`onModuleDestroy`, `onApplicationShutdown`) mahdollistavat **kunnollisen sammutuksen** — mikä on kriittistä modernissa käyttöönottamisessa (kontainerit/orchestratorit lähettävät SIGTERM-signaaleja jatkuvasti käyttöönottamisen ja skaalaamisen aikana, ja ilman kunnollista siivousta vuotaa yhteyksiä ja aktiiviset pyynnöt kaatuvat, mikä rikkoo nolla-downtime-käyttöönottamisen).

Vakiokaava yhdistämiselle `onModuleInit`-vaiheessa ja yhteyksien katkaisu `onModuleDestroy`-vaiheessa (esim. Prisma/tietokanta-palveluille) on jokapäiväistä NestJS-tietoa, ja tietäminen hienovaraisesta vaatimuksesta kutsua `enableShutdownHooks()` (muutoin sammutushookit eivät toimi) on käytännöllinen, helposti unohdettava yksityiskohta.

Lifecycle-hookien hallitseminen on osa kestävien, tuotanto-valmiiden NestJS-palveluiden rakentamista, jotka käsittelevät resursseja ja käyttöönottamisia oikein.