Hogyan működik a middleware a FastAPI-ban?

Question

Accepted Answer

A FastAPI-ban a **middleware** olyan kód, amely **minden kérelemhez és válaszhoz** fut — becsomagolva az végpontjait, hogy olyan keresztmetszeti problémákat kezeljen, mint a naplózás, időzítés, CORS és fejléc hozzáadás. A FastAPI a Starlette middleware rendszerét használja (ASGI alapú).

## Egyéni middleware írása

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

A minta: a `await call_next(request)` előtti kód a **bejövő** úton fut (a végpont előtt), a `call_next` meghívja a végpontot, és az utána következő kód a **kimenő** úton fut (a választ módosítva). Ez becsomagol minden kérést — itt egy időzítési fejléc hozzáadása az összes válaszhoz.

## A kérelem/válasz folyam

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

## Beépített / gyakori 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
```

A middleware általában az `add_middleware` segítségével kerül hozzáadásra — a CORS (engedélyezze a cross-origin kéréseket), a GZip (tömörítse a válaszokat) és a megbízható gazdagép ellenőrzések tipikus beépített funkciók.

## A middleware gyakori felhasználási módjai

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

## Middleware vs függőségek

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

## Miért fontos

A middleware a megfelelő mechanizmus a FastAPI-ban a **globális, keresztmetszeti problémákhoz** — olyan logika, amely minden kérelemhez és válaszhoz érvényes, mint a naplózás, a kérelem időzítése, a CORS, a tömörítés és az egyéni fejléc.

Ennek megértése fontos az alkalmazások helyes szerkezetéhez: a middleware becsomagol minden végpontot (a előtt és után fut, az kérelem és válasz módosítása képességével), ami ideálissá teszi az alkalmazás szintű viselkedéshez, amely fárasztó lenne és hibalehetőséges lenne minden végpontban megismételni.

A **middleware** (globális, nyers kérelem/válasz szint) és a **függőségek** (végpontonkénti, elemzett/gépelt értékekhez és DI-hez való hozzáféréssel — jobb az auth és validáláshoz) közötti különbség ismerete kulcs a megfelelő eszköz kiválasztásához.

A gyakori igények, mint a CORS és a tömörítés, beépített middleware által kezelnek, míg az egyéni middleware a naplózást és a műszerelésnä kezeli — ez gyakorlati, gyakran használt tudást tesz szükségessé a jól strukturált, megfigyelhető API-k létrehozásához.