Thứ tự vòng đời request của NestJS là gì?

Question

Accepted Answer

**Vòng đời request** là chuỗi chính xác các thành phần mà một request đi qua trong NestJS — middleware, guard, interceptor, pipe, handler, rồi interceptor lại, và exception filter khi có lỗi. Biết thứ tự chính xác là then chốt để hiểu *khi nào* mỗi mảnh logic chạy.

## Thứ tự đầy đủ

```text
Request đến
   │
   ▼
1. MIDDLEWARE            (kiểu Express; req/res thô; chạy đầu tiên)
   │
   ▼
2. GUARDS                (phân quyền — trả về true để tiếp tục, false/ném để chặn)
   │
   ▼
3. INTERCEPTORS (pre)    (logic TRƯỚC handler — bắt đầu đếm thời gian, v.v.)
   │
   ▼
4. PIPES                 (validate/biến đổi các argument của handler — validate DTO)
   │
   ▼
5. ROUTE HANDLER         (method controller của bạn chạy)
   │
   ▼
6. INTERCEPTORS (post)   (logic SAU handler — biến đổi response)
   │
   ▼
Response

✗ Nếu một exception được ném ra Ở BẤT KỲ ĐÂU phía trên →
7. EXCEPTION FILTERS     (bắt nó và định dạng response lỗi)
```

## Tại sao thứ tự quan trọng (hệ quả thực tế)

```text
• Guard chạy TRƯỚC pipe → phân quyền được kiểm tra trước khi validate input
  (không có lý do gì validate một body cho một request không được phép)
• Pipe chạy NGAY TRƯỚC handler → handler luôn nhận argument đã validate/biến đổi
• Interceptor bao quanh handler → chúng có thể đo thời lượng và biến đổi output
• Filter bắt lỗi từ bất kỳ giai đoạn nào → xử lý lỗi tập trung, nhất quán
```

## Trong mỗi loại, thứ tự scope áp dụng

```text
Với mỗi loại (guard, interceptor, pipe), chúng chạy theo thứ tự scope này:
  Global → Controller → Method (route)
Vậy một guard toàn cục chạy trước một guard cấp controller, trước một guard cấp route.
```

## Một ví dụ cụ thể

```ts
@Controller("users")
@UseGuards(AuthGuard)                    // 2. kiểm tra phân quyền
@UseInterceptors(LoggingInterceptor)     // 3 (pre) + 6 (post)
export class UsersController {
  @Post()
  create(@Body() dto: CreateUserDto) {    // 4. ValidationPipe validate dto, 5. handler chạy
    return this.usersService.create(dto);
  }
}
// Luồng: middleware → AuthGuard → LoggingInterceptor(trước) → ValidationPipe →
//        create() → LoggingInterceptor(sau) → response (hoặc → filter khi lỗi)
```

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

Hiểu thứ tự vòng đời request là nền tảng để xây dựng các ứng dụng NestJS đúng đắn — nó xác định chính xác *khi nào* mỗi mảnh logic xuyên suốt thực thi, điều ảnh hưởng trực tiếp đến các quyết định thiết kế và debug.

Thứ tự có ý nghĩa thực tế, thực sự: **guard chạy trước pipe**, nên phân quyền được kiểm tra đúng đắn trước khi bận tâm validate input (một request không được phép bị từ chối trước khi validate); **pipe chạy ngay trước handler**, đảm bảo handler luôn nhận argument đã validate, đã biến đổi; **interceptor bao bọc handler** (chạy trước *và* sau), chính là điều cho phép chúng đo thời gian thực thi và biến đổi response; và **exception filter bắt lỗi từ bất kỳ giai đoạn nào**, cho phép xử lý lỗi tập trung.

Biết thứ tự này — cộng với thứ tự scope trong mỗi loại (global → controller → method) — cho phép bạn đặt logic vào đúng thành phần, dự đoán luồng thực thi, debug tại sao một thứ chạy (hoặc không chạy) khi mong đợi, và kiến trúc các tính năng đúng đắn.

Nó gắn kết tất cả các mảnh xử lý request của framework (middleware, guard, interceptor, pipe, filter) thành một mô hình tư duy mạch lạc, khiến đây trở thành một chủ đề quan trọng, thường được hỏi, phản ánh sự hiểu biết thực sự về cách NestJS xử lý request.