Bagaimana middleware bekerja di FastAPI?

Question

Accepted Answer

**Middleware** di FastAPI adalah kode yang berjalan untuk **setiap request dan response** — membungkus endpoint Anda untuk menangani cross-cutting concerns seperti logging, timing, CORS, dan menambah header. FastAPI menggunakan sistem middleware Starlette (berbasis ASGI).

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

Polannya: kode sebelum `await call_next(request)` berjalan di jalur **masuk** (sebelum endpoint), `call_next` memanggil endpoint, dan kode setelah berjalan di jalur **keluar** (memodifikasi response). Ini membungkus setiap request — di sini, menambah header timing ke semua response.

## Alur 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 bawaan / umum

```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 umumnya ditambahkan melalui `add_middleware` — CORS (izinkan cross-origin requests), GZip (kompres responses), dan trusted-host checks adalah built-ins tipikal.

## Kegunaan middleware yang umum

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

## Mengapa ini penting

Middleware adalah mekanisme yang tepat untuk **concerns global, cross-cutting** di FastAPI — logika yang harus diterapkan ke setiap request dan response, seperti logging, request timing, CORS, compression, dan custom headers.

Memahaminya penting untuk menstruktur aplikasi dengan benar: middleware membungkus semua endpoint (berjalan sebelum dan sesudah, dengan kemampuan memodifikasi baik request maupun response), menjadikannya ideal untuk perilaku app-wide yang akan membosankan dan rentan kesalahan untuk diulang di setiap endpoint.

Mengetahui perbedaan antara **middleware** (global, tingkat request/response mentah) dan **dependencies** (per-endpoint, dengan akses ke nilai yang diparsing/typed dan DI — lebih baik untuk auth dan validation) adalah kunci untuk memilih alat yang tepat.

Kebutuhan umum seperti CORS dan compression ditangani oleh middleware bawaan, sementara middleware custom mencakup logging dan instrumentation — membuat pengetahuan praktis dan sering digunakan ini penting untuk membangun API yang terstruktur dengan baik dan dapat diamati.