NestJS cung cấp những lifecycle hook nào?

Question

Accepted Answer

NestJS cung cấp **lifecycle hook** — các method bạn implement để chạy code tại các thời điểm cụ thể trong vòng đời của ứng dụng hoặc của một provider (khởi tạo và tắt). Chúng thiết yếu cho thiết lập (kết nối tới các tài nguyên) và dọn dẹp (đóng kết nối một cách duyên dáng).

## Các hook chính

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

async onModuleInit() {
    // chạy khi các dependency của MODULE host được resolve → làm KHỞI TẠO
    await this.connect();         // vd. mở một kết nối database
  }

async onApplicationShutdown(signal: string) {
    // chạy khi ứng dụng đang tắt → làm DỌN DẸP
    await this.disconnect();      // đóng kết nối, flush, giải phóng tài nguyên
  }
}
```

## Chuỗi vòng đời

```text
KHỞI TẠO (startup):
  onModuleInit()          → sau khi các provider của module được khởi tạo
  onApplicationBootstrap()→ sau khi TẤT CẢ module được khởi tạo (toàn ứng dụng sẵn sàng)

TẮT (kết thúc duyên dáng):
  onModuleDestroy()         → dọn dẹp khi các module bị hủy
  beforeApplicationShutdown() → trước khi việc tắt hoàn tất
  onApplicationShutdown(signal) → tắt cuối cùng (signal = SIGTERM, v.v.)
```

## Một cách dùng phổ biến: một Prisma service kết nối/ngắt kết nối

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

async onModuleInit() {
    await this.$connect();        // kết nối lúc khởi động
  }
  async onModuleDestroy() {
    await this.$disconnect();      // ngắt kết nối lúc tắt — giải phóng sạch sẽ
  }
}
```

Đây là pattern chuẩn cho các tài nguyên cần thiết lập/dọn dẹp tường minh — kết nối trong `onModuleInit`, giải phóng trong `onModuleDestroy`.

## Bật shutdown hook

```ts
// shutdown hook phải được bật tường minh
const app = await NestFactory.create(AppModule);
app.enableShutdownHooks();        // ❗ bắt buộc để onApplicationShutdown v.v. kích hoạt
```

Các shutdown hook chỉ chạy nếu bạn gọi `enableShutdownHooks()` — dễ quên, rồi dọn dẹp không bao giờ xảy ra.

## Tại sao graceful shutdown quan trọng

```text
Khi ứng dụng nhận SIGTERM (deploy, scale-down, container stop):
  ✗ Không có shutdown hook → kết nối để mở, công việc đang xử lý bị bỏ rơi
  ✓ Có shutdown hook → đóng DB/Redis/queue sạch sẽ, hoàn thành công việc → zero-downtime
```

## Tại sao điều này quan trọng

Lifecycle hook là quan trọng để quản lý tài nguyên đúng đắn trong các ứng dụng NestJS — chúng cung cấp các nơi phù hợp để thực hiện **khởi tạo** (mở kết nối database/Redis, tải dữ liệu, đăng ký với các dịch vụ) và, quan trọng nhất, **dọn dẹp duyên dáng** lúc tắt (đóng kết nối, flush buffer, hoàn thành công việc đang xử lý).

Hiểu chúng là thiết yếu cho độ tin cậy production: các **khởi tạo hook** (`onModuleInit`, `onApplicationBootstrap`) đảm bảo thiết lập xảy ra đúng thời điểm khi các dependency sẵn sàng, và các **shutdown hook** (`onModuleDestroy`, `onApplicationShutdown`) cho phép **graceful shutdown** — điều sống còn trong triển khai hiện đại (container/orchestrator gửi SIGTERM liên tục trong các deploy và scaling, và không có dọn dẹp đúng đắn bạn rò rỉ kết nối và bỏ rơi các request đang hoạt động, phá vỡ các triển khai zero-downtime).

Pattern chuẩn của việc kết nối trong `onModuleInit` và ngắt kết nối trong `onModuleDestroy` (vd. cho các service Prisma/database) là kiến thức NestJS hằng ngày, và biết yêu cầu tinh tế phải gọi `enableShutdownHooks()` (nếu không các shutdown hook lặng lẽ không bao giờ kích hoạt) là một chi tiết thực tế, dễ bỏ sót.

Nắm vững lifecycle hook là một phần của việc xây dựng các service NestJS vững chắc, sẵn sàng cho production xử lý tài nguyên và triển khai đúng đắn.