NestJS hangi lifecycle hook'larını sağlar?

Question

Accepted Answer

NestJS **lifecycle hook'ları** sağlar — uygulamanın veya bir sağlayıcının yaşam döngüsünün (başlatma ve kapatma) belirli anlarında kod çalıştırmak için uygulayan metodlar. Kaynakları bağlamak (bağlantı kurmak) gibi kurulum ve kapatma (bağlantıları düzgün bir şekilde kapatmak) gibi temizlik için gereklidirler.

## Ana hook'lar

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

## Lifecycle sırası

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

## Yaygın bir kullanım: Prisma servisinin bağlantı kurması/kesintiye uğratması

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

Bu, açık kurulum/yıkım gerektiren kaynaklar için standart desendir — `onModuleInit`'te bağlantı kurun, `onModuleDestroy`'da serbest bırakın.

## Shutdown hook'larını etkinleştirme

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

Shutdown hook'ları yalnızca `enableShutdownHooks()` çağırırsanız çalışır — unutması kolay, sonra temizlik asla gerçekleşmez.

## Neden zarif kapatma önemlidir

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

## Neden önemli

Lifecycle hook'ları, NestJS uygulamalarında kaynakları doğru bir şekilde yönetmek için önemlidir — **başlatma** (veritabanı/Redis bağlantılarını açmak, veri yüklemek, hizmetlere kaydolmak) ve kritik olarak kapatma işleminde **zarif temizlik** (bağlantıları kapatmak, arabellekleri boşaltmak, devam eden işi bitirmek) gerçekleştirmek için uygun yerler sağlarlar.

Bunları anlamak üretim güvenilirliği için gereklidir: **başlatma hook'ları** (`onModuleInit`, `onApplicationBootstrap`) bağımlılıklar hazır olduktan sonra kurulumun doğru zamanda gerçekleştiğini sağlar ve **shutdown hook'ları** (`onModuleDestroy`, `onApplicationShutdown`) **zarif kapatmayı** etkinleştirir — bu, modern dağıtımda (konteynerler/düzenleyiciler sürekli olarak dağıtımlar ve ölçekleme sırasında SIGTERM gönderiyor) ve uygun temizlik olmadan bağlantı sızıntısı oluşur ve etkin istekler bırakılır, sıfır kapalı kalma süreli dağıtımları kırarak, hayati öneme sahiptir.

`onModuleInit`'te bağlantı kurma ve `onModuleDestroy`'da bağlantıyı kesme standart deseni (örn. Prisma/veritabanı hizmetleri için) günlük NestJS bilgisidir ve `enableShutdownHooks()`'ü çağırma gereksinimini bilmek (yoksa shutdown hook'ları sessizce hiçbir zaman ateşlenmez) pratik, kaçırması kolay bir ayrıntıdır.

Lifecycle hook'larında ustalaşmak, kaynakları ve dağıtımları doğru bir şekilde ele alan, güvenilir, üretime hazır NestJS hizmetleri oluşturmanın bir parçasıdır.