Τι είναι middleware στο NestJS και πώς διαφέρει από guards/interceptors;

Question

Accepted Answer

**Middleware** είναι μια συνάρτηση που εκτελείται **πριν από τον route handler**, με πρόσβαση στα αντικείμενα request και response — την ίδια έννοια με το Express middleware. Το NestJS έχει επίσης guards, interceptors, pipes και filters, καθένα εκτελούμενο σε ένα συγκεκριμένο σημείο του request lifecycle με ξεχωριστό σκοπό. Το να γνωρίζετε ποιο να χρησιμοποιήσετε είναι κρίσιμο.

## Middleware — εκτελείται πρώτο, έχει πρόσβαση σε req/res

```ts
@Injectable()
export class LoggerMiddleware implements NestMiddleware {
  use(req: Request, res: Response, next: NextFunction) {
    console.log(`${req.method} ${req.url}`);   // logging, modifying req
    next();                                      // MUST call next() to continue
  }
}

// register in a module
export class AppModule implements NestModule {
  configure(consumer: MiddlewareConsumer) {
    consumer.apply(LoggerMiddleware).forRoutes("*");   // apply to routes
  }
}
```

Το middleware εκτελείται νωρίτερα, πριν από guards/interceptors/pipes, και λειτουργεί με raw `req`/`res` — καλό για logging, τροποποίηση request, CORS και ανησυχίες συμβατές με Express.

## Η πλήρης σειρά του request lifecycle

```text
Request →
  1. Middleware     (req/res; runs first, Express-style)
  2. Guards         (return true/false → AUTHORIZE or block the request)
  3. Interceptors   (BEFORE the handler)
  4. Pipes          (validate/transform the handler's arguments)
  5. → Route Handler ←
  6. Interceptors   (AFTER the handler — transform the response)
  7. Exception Filters (if an error was thrown anywhere)
→ Response
```

## Για τι είναι κάθε ένα (επιλογή του σωστού εργαλείου)

```text
Middleware  → general pre-processing with req/res (logging, CORS, raw request work)
Guards      → AUTHORIZATION — decide if a request may proceed (auth, roles)
              (return true = allow, false/throw = block)
Interceptors→ wrap the handler — transform request/response, add logging/caching/timing
              (can run logic BEFORE and AFTER the handler)
Pipes       → VALIDATE/TRANSFORM the handler's input arguments (DTO validation)
Filters     → catch and format EXCEPTIONS into responses
```

Οι βασικές διακρίσεις: το middleware είναι γενική pre-processing σε στυλ Express· **guards** χειρίζονται ειδικά την εξουσιοδότηση (ένα καθαρό, αποκλειστικό μέρος για auth, σε αντίθεση με το να το βάζετε σε middleware)· **interceptors** περιτυλίγουν τον handler για να μετατρέψουν τις απαντήσεις ή να προσθέσουν cross-cutting behavior· **pipes** επικυρώνουν την είσοδο· **filters** χειρίζονται σφάλματα.

## Πότε να χρησιμοποιήσετε middleware vs guards vs interceptors

```text
Auth check?           → Guard (dedicated, has execution context, returns boolean)
Logging requests?     → Middleware OR an interceptor (interceptor sees the response too)
Transform responses?  → Interceptor (runs after the handler)
Validate a DTO?       → Pipe
Modify raw req early?  → Middleware
```

## Γιατί είναι σημαντικό

Η κατανόηση του middleware και του πώς διαφέρει από guards, interceptors, pipes και filters είναι απαραίτητη για τη σωστή δόμηση εφαρμογών NestJS — καθένα έχει ένα συγκεκριμένο ρόλο και εκτελείται σε ένα συγκεκριμένο σημείο του request lifecycle, και η χρήση του σωστού οδηγεί σε καθαρό, idiomatικό κώδικα.

Το middleware χειρίζεται γενική pre-processing σε στυλ Express με raw req/res.

Οι κρίσιμες διακρίσεις είναι ότι **guards** είναι το αποκλειστικό, σωστό μέρος για εξουσιοδότηση (auth/roles) — πολύ πιο καθαρό από middleware για τον σκοπό αυτό — και **interceptors** περιτυλίγουν τον handler για να μετατρέψουν τις απαντήσεις και να προσθέσουν cross-cutting concerns (logging, caching, timing) που το middleware δεν μπορεί εύκολα να κάνει (αφού εκτελείται πριν από τον handler και δεν βλέπει φυσικά την απάντηση).

Η γνώση της πλήρους σειράς του lifecycle (middleware → guards → interceptors → pipes → handler → interceptors → filters) και ποιο εργαλείο ταιριάζει σε κάθε ανησυχία (auth → guard, response transformation → interceptor, validation → pipe, errors → filter) είναι ένα σημάδι ικανότητας στο NestJS και αποτρέπει το συνηθισμένο λάθος της κακής χρήσης του middleware για τα πάντα.

Αυτό είναι ένα συχνά δοκιμαζόμενο, αρχιτεκτονικά σημαντικό θέμα στο framework.