Bạn xử lý exception trong NestJS như thế nào?

Question

Accepted Answer

NestJS có một **lớp xử lý exception tích hợp sẵn** tự động bắt các lỗi không được xử lý và biến chúng thành các HTTP response đúng đắn. Bạn báo hiệu lỗi bằng cách **ném exception** (thường là các class HTTP exception tích hợp sẵn), và Nest định dạng chúng thành các JSON response có cấu trúc với đúng mã trạng thái.

## Ném các HTTP exception tích hợp sẵn

```ts
import { NotFoundException, BadRequestException, UnauthorizedException } from "@nestjs/common";

@Get(":id")
findOne(@Param("id") id: string) {
  const user = this.usersService.findOne(id);
  if (!user) {
    throw new NotFoundException("User not found");   // → 404 kèm body lỗi JSON
  }
  return user;
}
```

NestJS cung cấp các class exception ánh xạ tới các mã trạng thái HTTP, và ném một cái sẽ tạo ra một response đúng đắn, có cấu trúc một cách tự động:

```json
{ "statusCode": 404, "message": "User not found", "error": "Not Found" }
```

## Các HTTP exception tích hợp phổ biến

```text
BadRequestException        → 400
UnauthorizedException      → 401
ForbiddenException         → 403
NotFoundException          → 404
ConflictException          → 409
UnprocessableEntityException → 422
InternalServerErrorException → 500
```

Có một class cho mỗi lỗi HTTP phổ biến — dùng cái phù hợp để truyền đạt đúng trạng thái.

## Thông điệp tùy chỉnh và HttpException tổng quát

```ts
// trạng thái + body tùy chỉnh qua HttpException gốc
throw new HttpException(
  { status: HttpStatus.FORBIDDEN, error: "custom message" },
  HttpStatus.FORBIDDEN,
);
```

## Các class exception tùy chỉnh

```ts
export class UserNotFoundException extends NotFoundException {
  constructor(id: string) {
    super(`User with id ${id} not found`);   // theo lĩnh vực, tái sử dụng được
  }
}
throw new UserNotFoundException(id);
```

## Lỗi không được xử lý trở thành 500

```text
Nếu code ném một lỗi không phải HttpException (vd. một Error thuần hoặc một exception
bất ngờ), exception filter mặc định của NestJS bắt nó và trả về một lỗi
500 Internal Server Error tổng quát (không rò rỉ chi tiết nội bộ cho client).
```

## Exception filter cho tùy chỉnh toàn cục

```ts
// một custom exception filter tùy chỉnh cách lỗi được định dạng/ghi log toàn cục
@Catch()
export class AllExceptionsFilter implements ExceptionFilter {
  catch(exception: unknown, host: ArgumentsHost) {
    // ghi log, định dạng response, v.v.
  }
}
app.useGlobalFilters(new AllExceptionsFilter());   // áp dụng toàn ứng dụng
```

Để định dạng lỗi nhất quán, ghi log, hoặc xử lý các lỗi không phải HTTP, bạn dùng **exception filter** (một tính năng liên quan, nâng cao hơn).

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

Xử lý exception đúng đắn là thiết yếu để xây dựng các API đáng tin cậy, và lớp xử lý exception tích hợp của NestJS làm cho nó sạch sẽ và nhất quán.

Hiểu cách **ném HTTP exception** (`NotFoundException`, `BadRequestException`, v.v.) là kiến thức hằng ngày — đó là cách thành ngữ để báo hiệu lỗi với đúng mã trạng thái và các JSON response có cấu trúc, thân thiện với client, mà không cần dựng response lỗi thủ công trong mỗi handler.

Framework tự động bắt chúng và định dạng, và nó an toàn chuyển các lỗi bất ngờ thành 500 tổng quát mà không rò rỉ chi tiết nội bộ (quan trọng cho bảo mật).

Biết các class exception phổ biến, cách ném thông điệp/exception tùy chỉnh, và rằng **exception filter** tồn tại cho tùy chỉnh toàn cục (định dạng nhất quán, ghi log) là nền tảng để xây dựng các API NestJS vững chắc, chuyên nghiệp.

Xử lý lỗi sạch sẽ, nhất quán là dấu ấn của code back-end chất lượng, khiến đây trở thành một khía cạnh cốt lõi, thường dùng của framework.