Middleware ทำงานอย่างไรใน FastAPI?

Question

Accepted Answer

**Middleware** ใน FastAPI คือโค้ดที่ทำงานสำหรับ **ทุก request และ response** — ห่อหุ้ม endpoints ของคุณเพื่อจัดการกับเรื่องที่ตัดข้ามกัน (cross-cutting concerns) เช่น logging, การจับเวลา, CORS และการเพิ่ม headers FastAPI ใช้ระบบ middleware ของ Starlette (มันเป็น ASGI-based)

## การเขียน 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
```

pattern คือ: โค้ดก่อน `await call_next(request)` ทำงานในขา **เข้า** (ก่อน endpoint), `call_next` เรียก endpoint และโค้ดหลังจากนั้นทำงานในขา **ออก** (แก้ไข response) สิ่งนี้ห่อหุ้มทุก request — ในที่นี้คือการเพิ่ม timing header ให้ทุก response

## flow ของ 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 ที่มีในตัว / ที่ใช้บ่อย

```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 มักถูกเพิ่มผ่าน `add_middleware` — CORS (อนุญาต cross-origin requests), GZip (บีบอัด responses) และการตรวจสอบ trusted-host เป็น built-ins ทั่วไป

## การใช้งาน middleware ที่พบบ่อย

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

## middleware เทียบกับ 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.
```

## ทำไมจึงสำคัญ

Middleware เป็นกลไกที่เหมาะสมสำหรับ **เรื่องที่ตัดข้ามกันแบบ global** ใน FastAPI — logic ที่ควรใช้กับทุก request และ response เช่น logging, การจับเวลา request, CORS, การบีบอัด และ custom headers

การเข้าใจมันมีความสำคัญต่อการจัดโครงสร้างแอปพลิเคชันอย่างถูกต้อง: middleware ห่อหุ้มทุก endpoint (ทำงานก่อนและหลัง พร้อมความสามารถในการแก้ไขทั้ง request และ response) ทำให้เหมาะสำหรับพฤติกรรมระดับแอปทั้งหมดที่จะน่าเบื่อและเกิดข้อผิดพลาดได้ง่ายหากต้องทำซ้ำในทุก endpoint

การรู้ความแตกต่างระหว่าง **middleware** (global, ระดับ raw request/response) และ **dependencies** (per-endpoint, เข้าถึงค่าที่ parse/typed แล้วและ DI ได้ — ดีกว่าสำหรับ auth และ validation) เป็นกุญแจสำคัญในการเลือกเครื่องมือที่ถูกต้อง

ความต้องการที่พบบ่อยอย่าง CORS และการบีบอัดถูกจัดการโดย middleware ที่มีในตัว ขณะที่ custom middleware ครอบคลุม logging และ instrumentation — ทำให้นี่เป็นความรู้ในทางปฏิบัติที่ใช้บ่อยในการสร้าง API ที่มีโครงสร้างดีและสังเกตได้ (observable)