Hvordan fungerer middleware i FastAPI?

Question

Accepted Answer

**Middleware** i FastAPI er kode som kjøres for **hver forespørsel og respons** — den omslutter endepunktene dine for å håndtere tverrgående bekymringer som logging, timing, CORS og legge til headere. FastAPI bruker Starlettes middleware-system (det er ASGI-basert).

## Skrive egendefinert 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
```

Mønsteret: kode før `await call_next(request)` kjøres **på vei inn** (før endepunktet), `call_next` påkaller endepunktet, og kode etter kjøres **på vei ut** (modifisering av responsen). Dette omslutter hver forespørsel — her legges en timing-header til alle responser.

## Request/response-flyten

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

## Innebygd / vanlig 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 legges vanligvis til via `add_middleware` — CORS (tillat tverrorriginforespørsler), GZip (komprimer responser) og trusted-host-kontroller er typiske innebygde verktøy.

## Vanlige middleware-bruksområder

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

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

## Hvorfor det betyr noe

Middleware er riktig mekanisme for **globale, tverrgående bekymringer** i FastAPI — logikk som skal gjelde hver forespørsel og respons, som logging, forespørselstiming, CORS, komprimering og egendefinerte headere.

Å forstå det er viktig for å strukturere applikasjoner korrekt: middleware omslutter alle endepunkter (kjøres før og etter, med evne til å modifisere både forespørsel og respons), noe som gjør det ideelt for appbred oppførsel som ville være kjedelig og feilprosent å gjenta i hvert endepunkt.

Å kjenne skillet mellom **middleware** (globalt, råt request/response-nivå) og **avhengigheter** (per-endepunkt, med tilgang til analyserte/skrevne verdier og DI — bedre for autentisering og validering) er nøkkelen til å velge riktig verktøy.

Vanlige behov som CORS og komprimering håndteres av innebygd middleware, mens egendefinert middleware dekker logging og instrumentering — noe som gjør denne praktiske, hyppig brukt kunnskapen for å bygge velstrukturerte, observerbare API-er.