Middleware hoạt động như thế nào trong FastAPI?

Question

Accepted Answer

**Middleware** trong FastAPI là code chạy cho **mọi request và response** — bao bọc các endpoint của bạn để xử lý các mối quan tâm xuyên suốt như logging, đo thời gian, CORS, và thêm header. FastAPI dùng hệ thống middleware của Starlette (nó dựa trên ASGI).

## Viết middleware tùy chỉnh

```python
import time

@app.middleware("http")
async def add_timing(request: Request, call_next):
    start = time.time()
    response = await call_next(request)        # gọi endpoint (và bất kỳ middleware bên trong nào)
    response.headers["X-Process-Time"] = str(time.time() - start)   # chỉnh sửa response
    return response
```

Pattern: code trước `await call_next(request)` chạy trên đường **vào** (trước endpoint), `call_next` gọi endpoint, và code sau chạy trên đường **ra** (chỉnh sửa response). Điều này bao bọc mọi request — ở đây, thêm một header thời gian vào mọi response.

## Luồng request/response

```text
Request  → MW1 → MW2 → endpoint
Response ← MW1 ← MW2 ← endpoint
Middleware bao bọc endpoint; chạy theo thứ tự trên đường vào, ngược lại trên đường ra.
```

## Middleware tích hợp / phổ biến

```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)                               # nén
```

Middleware thường được thêm qua `add_middleware` — CORS (cho phép request cross-origin), GZip (nén response), và kiểm tra trusted-host là các tích hợp điển hình.

## Các trường hợp dùng middleware phổ biến

```text
✓ Logging / đo thời gian request / metrics
✓ CORS (xử lý request cross-origin)
✓ Thêm header bảo mật hoặc tùy chỉnh
✓ Nén response (GZip)
✓ Tiêm Request ID / correlation ID
```

## Middleware so với dependency

```text
Middleware   → chạy cho TẤT CẢ request; làm việc ở mức request/response thô (header,
               thời gian, toàn bộ response). Tốt nhất cho các mối quan tâm thực sự toàn cục.
Dependency   → logic theo từng endpoint (hoặc nhóm) với quyền truy cập tham số đã parse, DI, và
               giá trị có kiểu. Tốt nhất cho auth, validation, tham số dùng chung.
→ Dùng middleware cho mối quan tâm xuyên suốt toàn cục; dependency cho logic endpoint.
```

## Tại sao điều này quan trọng

Middleware là cơ chế phù hợp cho các **mối quan tâm xuyên suốt, toàn cục** trong FastAPI — logic nên áp dụng cho mọi request và response, như logging, đo thời gian request, CORS, nén, và header tùy chỉnh.

Hiểu nó quan trọng để cấu trúc ứng dụng đúng đắn: middleware bao bọc mọi endpoint (chạy trước và sau, với khả năng chỉnh sửa cả request lẫn response), khiến nó lý tưởng cho hành vi toàn ứng dụng vốn sẽ nhàm chán và dễ lỗi nếu lặp lại trong mọi endpoint.

Biết sự phân biệt giữa **middleware** (toàn cục, mức request/response thô) và **dependency** (theo từng endpoint, với quyền truy cập giá trị đã parse/có kiểu và DI — tốt hơn cho auth và validation) là then chốt để chọn đúng công cụ.

Các nhu cầu phổ biến như CORS và nén được xử lý bởi middleware tích hợp, trong khi middleware tùy chỉnh bao quát logging và instrumentation — biến đây thành kiến thức thực tiễn, thường dùng để xây dựng API có cấu trúc tốt, quan sát được.