Πώς χειρίζεστε τις εξαιρέσεις στο NestJS;

Question

Accepted Answer

Το NestJS έχει ένα **ενσωματωμένο επίπεδο εξαιρέσεων** που αυτόματα συλλαμβάνει ανεχείριστα σφάλματα και τα μετατρέπει σε κατάλληλες HTTP απαντήσεις. Σηματοδοτείτε σφάλματα **ρίχνοντας εξαιρέσεις** (συχνά ενσωματωμένες κλάσεις HTTP εξαιρέσεων), και το Nest τα μορφοποιεί σε δομημένες JSON απαντήσεις με τον σωστό κωδικό κατάστασης.

## Ρίψη ενσωματωμένων HTTP εξαιρέσεων

```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 παρέχει κλάσεις εξαιρέσεων που αντιστοιχούν σε κωδικούς κατάστασης HTTP, και η ρίψη μιας παράγει αυτόματα μια σωστή, δομημένη απάντηση:

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

## Κοινές ενσωματωμένες HTTP εξαιρέσεις

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

Υπάρχει μια κλάση για κάθε κοινό σφάλμα HTTP — χρησιμοποιήστε την κατάλληλη για να επικοινωνήσετε τη σωστή κατάσταση.

## Προσαρμοσμένα μηνύματα και το γενικό HttpException

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

## Προσαρμοσμένες κλάσεις εξαιρέσεων

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

## Ανεχείριστα σφάλματα γίνονται 500s

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

## Φίλτρα εξαιρέσεων για παγκόσμια προσαρμογή

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

Για συνεπή μορφοποίηση σφαλμάτων, καταγραφή ή χειρισμό σφαλμάτων που δεν είναι HTTP, χρησιμοποιείτε **φίλτρα εξαιρέσεων** (μια σχετική, πιο προχωρημένη λειτουργία).

## Γιατί έχει σημασία

Σωστός χειρισμός εξαιρέσεων είναι απαραίτητος για την κατασκευή αξιόπιστων API, και το ενσωματωμένο επίπεδο εξαιρέσεων του NestJS το κάνει καθαρό και συνεπές.

Η κατανόηση του πώς να **ρίξετε HTTP εξαιρέσεις** (`NotFoundException`, `BadRequestException`, κλπ.) είναι καθημερινή γνώση — είναι ο ιδιωματικός τρόπος να σηματοδοτήσετε σφάλματα με τους σωστούς κωδικούς κατάστασης και δομημένες, φιλικές προς τον πελάτη JSON απαντήσεις, χωρίς να χτίζετε ručně απαντήσεις σφαλμάτων σε κάθε χειριστή.

Το framework αυτόματα τα συλλαμβάνει και τα μορφοποιεί, και ασφαλώς μετατρέπει απροσδόκητα σφάλματα σε γενικές 500s χωρίς να διαρρέουν εσωτερικές λεπτομέρειες (σημαντικό για την ασφάλεια).

Η γνώση των κοινών κλάσεων εξαιρέσεων, του πώς να ρίχνετε προσαρμοσμένα μηνύματα/εξαιρέσεις, και ότι **φίλτρα εξαιρέσεων** υπάρχουν για παγκόσμια προσαρμογή (συνεπής μορφοποίηση, καταγραφή) είναι θεμελιώδης για την κατασκευή ισχυρών, επαγγελματικών NestJS API.

Καθαρός, συνεπής χειρισμός σφαλμάτων είναι χαρακτηριστικό κώδικα ποιότητας back-end, κάνοντας αυτό ένα βασικό, συχνά χρησιμοποιούμενο πλευρό του framework.