Bagaimanakah middleware berfungsi di FastAPI?

Question

Accepted Answer

**Middleware** dalam FastAPI adalah kode yang berjalan untuk **setiap request dan response** — membungkus endpoint Anda untuk menangani masalah lintas-potong seperti logging, timing, CORS, dan menambahkan header. FastAPI menggunakan sistem middleware Starlette (berbasis ASGI).

## Menulis middleware khusus

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

Polanya: kode sebelum `await call_next(request)` berjalan **masuk** (sebelum endpoint), `call_next` memanggil endpoint, dan kode sesudahnya berjalan **keluar** (memodifikasi response). Ini membungkus setiap request — di sini, menambahkan 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 biasanya ditambahkan melalui `add_middleware` — CORS (izinkan request lintas-origin), GZip (kompresi response), dan pemeriksaan trusted-host adalah bawaan khas.

## Penggunaan 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 hal ini penting

Middleware adalah mekanisme yang tepat untuk **masalah global dan lintas-potong** di FastAPI — logika yang harus diterapkan ke setiap request dan response, seperti logging, timing request, CORS, kompresi, dan header khusus.

Memahaminya penting untuk menstruktur aplikasi dengan benar: middleware membungkus semua endpoint (berjalan sebelum dan sesudah, dengan kemampuan memodifikasi request dan response), membuatnya ideal untuk perilaku tingkat app yang akan membosankan dan rawan kesalahan untuk diulang di setiap endpoint.

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

Kebutuhan umum seperti CORS dan kompresi ditangani oleh middleware bawaan, sementara middleware khusus mencakup logging dan instrumentasi — menjadikan ini pengetahuan praktis dan sering digunakan untuk membangun API yang terstruktur dengan baik dan dapat diamati.