NestJS มี lifecycle hook อะไรบ้าง?

Question

Accepted Answer

NestJS มี **lifecycle hook** ซึ่งเป็นเมธอดที่คุณ implement เพื่อรันโค้ด ณ จังหวะเวลาเฉพาะใน lifecycle ของแอปพลิเคชันหรือของ provider (ตอน initialization และ shutdown) มันจำเป็นสำหรับการตั้งค่า (เชื่อมต่อทรัพยากร) และการเก็บกวาด (ปิด connection อย่างเรียบร้อย)

## hook หลักๆ

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

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

## การใช้งานทั่วไป: Prisma service ที่เชื่อมต่อ/ตัดการเชื่อมต่อ

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

## การเปิดใช้งาน shutdown hook

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

shutdown hook จะทำงานก็ต่อเมื่อคุณเรียก `enableShutdownHooks()` เท่านั้น ซึ่งลืมได้ง่าย แล้วการเก็บกวาดก็จะไม่เกิดขึ้นเลย

## ทำไม graceful shutdown จึงสำคัญ

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

## ทำไมจึงสำคัญ

Lifecycle hook มีความสำคัญต่อการจัดการทรัพยากรอย่างถูกต้องในแอปพลิเคชัน NestJS โดยมอบจุดที่เหมาะสมในการทำ **initialization** (เปิด database/Redis connection, โหลดข้อมูล, ลงทะเบียนกับ service ต่างๆ) และที่สำคัญยิ่งคือการ **เก็บกวาดอย่างเรียบร้อย** ตอน shutdown (ปิด connection, flush buffer, ทำงานที่ค้างอยู่ให้เสร็จ)

การเข้าใจสิ่งเหล่านี้จำเป็นต่อความน่าเชื่อถือระดับ production: **initialization hook** (`onModuleInit`, `onApplicationBootstrap`) ทำให้การตั้งค่าเกิดขึ้น ณ เวลาที่ถูกต้องเมื่อ dependency พร้อมแล้ว และ **shutdown hook** (`onModuleDestroy`, `onApplicationShutdown`) ทำให้เกิด **graceful shutdown** ซึ่งสำคัญยิ่งใน deployment สมัยใหม่ (container/orchestrator ส่ง SIGTERM อยู่ตลอดเวลาในระหว่าง deploy และ scaling และถ้าไม่มีการเก็บกวาดที่เหมาะสม คุณจะปล่อย connection รั่วและทิ้ง request ที่กำลังทำงานอยู่ ทำลาย zero-downtime deployment)

แพทเทิร์นมาตรฐานของการเชื่อมต่อใน `onModuleInit` และตัดการเชื่อมต่อใน `onModuleDestroy` (เช่นสำหรับ Prisma/database service) คือความรู้ NestJS ในชีวิตประจำวัน และการรู้ข้อกำหนดที่ละเอียดอ่อนว่าต้องเรียก `enableShutdownHooks()` (ไม่งั้น shutdown hook จะไม่ทำงานเงียบๆ) เป็นรายละเอียดเชิงปฏิบัติที่พลาดได้ง่าย

การเชี่ยวชาญ lifecycle hook เป็นส่วนหนึ่งของการสร้าง NestJS service ที่แข็งแกร่งและพร้อมใช้งานจริง ซึ่งจัดการทรัพยากรและ deployment ได้อย่างถูกต้อง