Πώς λειτουργεί το middleware στο FastAPI;

Question

Accepted Answer

**Middleware** στο FastAPI είναι κώδικας που εκτελείται για **κάθε request και response** — περιτυλίγει τα endpoints σας για να χειριστεί cross-cutting concerns όπως logging, timing, CORS και προσθήκη headers. Το FastAPI χρησιμοποιεί το σύστημα middleware του Starlette (είναι βασισμένο σε ASGI).

## Γράφοντας custom middleware

```python
import time

@app.middleware("http")
async def add_timing(request: Request, call_next):
    start = time.time()
    response = await call_next(request)        # call the endpoint (and any inner middleware)
    response.headers["X-Process-Time"] = str(time.time() - start)   # modify the response
    return response
```

Το πρότυπο: ο κώδικας πριν από το `await call_next(request)` εκτελείται στην πορεία **προς τα μέσα** (πριν από το endpoint), το `call_next` επικαλεί το endpoint και ο κώδικας μετά εκτελείται στην πορεία **προς τα έξω** (τροποποιώντας το response). Αυτό περιτυλίγει κάθε request — εδώ, προστίθεται ένα timing header σε όλα τα responses.

## Η ροή request/response

```text
Request  → MW1 → MW2 → endpoint
Response ← MW1 ← MW2 ← endpoint
Middleware wraps the endpoint; runs in order on the way in, reverse on the way out.
```

## Ενσωματωμένο / κοινό middleware

```python
from fastapi.middleware.cors import CORSMiddleware
from fastapi.middleware.gzip import GZipMiddleware

app.add_middleware(CORSMiddleware, allow_origins=["https://app.example.com"], ...)  # CORS
app.add_middleware(GZipMiddleware, minimum_size=1000)                               # compression
```

Το Middleware προστίθεται συνήθως μέσω του `add_middleware` — CORS (επιτρέπει cross-origin requests), GZip (συμπίεση responses) και έλεγχοι trusted-host είναι τυπικά ενσωματωμένα.

## Κοινές χρήσεις middleware

```text
✓ Logging / request timing / metrics
✓ CORS (cross-origin request handling)
✓ Adding security or custom headers
✓ Response compression (GZip)
✓ Request ID / correlation ID injection
```

## Middleware έναντι dependencies

```text
Middleware   → runs for ALL requests; works at the raw request/response level (headers,
               timing, the whole response). Best for truly global concerns.
Dependencies → per-endpoint (or grouped) logic with access to parsed params, DI, and
               typed values. Best for auth, validation, shared parameters.
→ Use middleware for global cross-cutting concerns; dependencies for endpoint logic.
```

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

Το Middleware είναι ο σωστός μηχανισμός για **καθολικές, cross-cutting concerns** στο FastAPI — λογική που θα πρέπει να ισχύει για κάθε request και response, όπως logging, request timing, CORS, συμπίεση και custom headers.

Η κατανόησή του είναι σημαντική για τη σωστή δομή των εφαρμογών: το middleware περιτυλίγει όλα τα endpoints (εκτελείται πριν και μετά, με την ικανότητα να τροποποιεί τόσο το request όσο και το response), καθιστώντας το ιδανικό για συμπεριφορά σε όλη την εφαρμογή που θα ήταν κουραστική και επιρρεπής σε σφάλματα να επαναλαμβάνεται σε κάθε endpoint.

Η γνώση της διάκρισης μεταξύ **middleware** (καθολικό, επίπεδο raw request/response) και **dependencies** (ανά-endpoint, με πρόσβαση σε αναλυμένες/τυποποιημένες τιμές και DI — καλύτερο για auth και validation) είναι το κλειδί για την επιλογή του σωστού εργαλείου.

Οι κοινές ανάγκες όπως CORS και συμπίεση αντιμετωπίζονται από το ενσωματωμένο middleware, ενώ το custom middleware καλύπτει logging και instrumentation — καθιστώντας αυτή τη γνώση πρακτική, συχνά χρησιμοποιούμενη για τη δημιουργία καλά δομημένων, παρατηρήσιμων API.