คุณจัดการ exception ใน NestJS อย่างไร?

Question

Accepted Answer

NestJS มี **ชั้น exception ในตัว (exception layer)** ที่ดักจับ error ที่ไม่ได้จัดการโดยอัตโนมัติและแปลงเป็น HTTP response ที่เหมาะสม คุณส่งสัญญาณ error ด้วยการ **throw exception** (มักเป็นคลาส HTTP exception ในตัว) แล้ว Nest จะจัดรูปแบบมันเป็น JSON response ที่มีโครงสร้างพร้อม status code ที่ถูกต้อง

## การ throw HTTP exception ในตัว

```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 with a JSON error body
  }
  return user;
}
```

NestJS มีคลาส exception ที่แมปกับ HTTP status code และการ throw หนึ่งในนั้นจะสร้าง response ที่ถูกต้องและมีโครงสร้างโดยอัตโนมัติ:

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

## HTTP exception ในตัวที่พบบ่อย

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

มีคลาสสำหรับ HTTP error ที่พบบ่อยแต่ละชนิด — ใช้ตัวที่เหมาะสมเพื่อสื่อสาร status ที่ถูกต้อง

## ข้อความที่กำหนดเองและ HttpException ทั่วไป

```ts
// custom status + body via the base HttpException
throw new HttpException(
  { status: HttpStatus.FORBIDDEN, error: "custom message" },
  HttpStatus.FORBIDDEN,
);
```

## คลาส exception ที่กำหนดเอง

```ts
export class UserNotFoundException extends NotFoundException {
  constructor(id: string) {
    super(`User with id ${id} not found`);   // domain-specific, reusable
  }
}
throw new UserNotFoundException(id);
```

## error ที่ไม่ได้จัดการกลายเป็น 500

```text
If code throws a non-HttpException error (e.g. a plain Error or an unexpected
exception), NestJS's default exception filter catches it and returns a generic
500 Internal Server Error (without leaking internal details to the client).
```

## Exception filter สำหรับการปรับแต่งระดับ global

```ts
// a custom exception filter customizes how errors are formatted/logged globally
@Catch()
export class AllExceptionsFilter implements ExceptionFilter {
  catch(exception: unknown, host: ArgumentsHost) {
    // log, format the response, etc.
  }
}
app.useGlobalFilters(new AllExceptionsFilter());   // apply app-wide
```

สำหรับการจัดรูปแบบ error, logging หรือจัดการ error ที่ไม่ใช่ HTTP อย่างสม่ำเสมอ คุณใช้ **exception filter** (ฟีเจอร์ที่เกี่ยวข้องและขั้นสูงกว่า)

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

การจัดการ exception อย่างเหมาะสมเป็นสิ่งจำเป็นต่อการสร้าง API ที่เชื่อถือได้ และชั้น exception ในตัวของ NestJS ทำให้มันสะอาดและสม่ำเสมอ

การเข้าใจวิธี **throw HTTP exception** (`NotFoundException`, `BadRequestException` ฯลฯ) เป็นความรู้ที่ใช้ทุกวัน — เป็นวิธีตามแบบฉบับ (idiomatic) ในการส่งสัญญาณ error พร้อม status code ที่ถูกต้องและ JSON response ที่มีโครงสร้างและเป็นมิตรต่อ client โดยไม่ต้องสร้าง error response เองด้วยมือในทุก handler

เฟรมเวิร์กดักจับสิ่งเหล่านี้และจัดรูปแบบให้โดยอัตโนมัติ และแปลง error ที่ไม่คาดคิดเป็น 500 ทั่วไปอย่างปลอดภัยโดยไม่เปิดเผยรายละเอียดภายใน (สำคัญต่อความปลอดภัย)

การรู้จักคลาส exception ที่พบบ่อย, วิธี throw ข้อความ/exception ที่กำหนดเอง และว่า **exception filter** มีไว้สำหรับการปรับแต่งระดับ global (การจัดรูปแบบที่สม่ำเสมอ, logging) เป็นพื้นฐานของการสร้าง API NestJS ที่ทนทานและเป็นมืออาชีพ

การจัดการ error ที่สะอาดและสม่ำเสมอเป็นเครื่องหมายของโค้ด back-end ที่มีคุณภาพ ทำให้นี่เป็นด้านหลักที่ใช้บ่อยของเฟรมเวิร์ก