NestJS'te middleware nedir ve guard'lar/interceptor'lardan farkı nedir?

Question

Accepted Answer

**Middleware**, rota işleyicisinden **önce çalışan** ve request ve response nesnelerine erişime sahip olan bir fonksiyondur — Express middleware ile aynı konsepttir. NestJS ayrıca guard'lar, interceptor'lar, pipe'lar ve filter'lar barındırır; her biri request yaşam döngüsünün belirli bir noktasında çalışır ve farklı bir amaca hizmet eder. Hangisini kullanacağını bilmek önemlidir.

## Middleware — ilk çalışır, req/res'e sahiptir

```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 en erken çalışır, guard'lar/interceptor'lar/pipe'lardan önce, ve ham `req`/`res` ile çalışır — logging, request değişikliği, CORS ve Express uyumlu konular için iyidir.

## Tam request yaşam döngüsü sırası

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

## Her birinin amacı (doğru aracı seçme)

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

Ana farklar: middleware genel Express tarzı ön işleme; **guard'lar** özel olarak yetkilendirmeyi (auth için temiz, ayrılmış bir yer, middleware'e sıkıştırmaktan farklı); **interceptor'lar** yanıtları dönüştürmek veya çapraz kesintili davranış eklemek için işleyiciyi sarar; **pipe'lar** giriş doğrulaması; **filter'lar** hataları işler.

## Middleware vs guard'lar vs interceptor'lar ne zaman kullanılır

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

## Neden önemli

Middleware'i ve bunun guard'lar, interceptor'lar, pipe'lar ve filter'lardan farkını anlamak, NestJS uygulamalarını doğru şekilde yapılandırmak için gereklidir — her birinin belirli bir rolü vardır ve request yaşam döngüsünün belirli bir noktasında çalışır; doğru olanını kullanmak temiz, idiyomatik koda yol açar.

Middleware, ham req/res ile genel Express tarzı ön işlemeyi yönetir.

Çok önemli farklar şunlardır: **guard'lar** yetkilendirme için ayrılmış, uygun yerdir (auth/roller) — bu amaç için middleware'den çok daha temizdir — ve **interceptor'lar** yanıtları dönüştürmek ve çapraz kesintili endişeleri (logging, caching, timing) eklemek için işleyiciyi sarmalır; middleware bunu kolayca yapamaz (çünkü işleyiciden önce çalışır ve doğal olarak yanıtı görmez).

Tam yaşam döngüsü sırasını (middleware → guard'lar → interceptor'lar → pipe'lar → işleyici → interceptor'lar → filter'lar) ve her endişeye hangi aracın uyduğunu (auth → guard, yanıt dönüşümü → interceptor, doğrulama → pipe, hatalar → filter) bilmek NestJS yeterliliğinin bir göstergesidir ve her şey için middleware'i yanlış kullanmanın yaygın hatasını önler.

Bu çerçevede sıkça test edilen, mimarilsel olarak önemli bir konudur.