FastAPI मध्ये middleware कसे काम करते?

Question

Accepted Answer

**Middleware** FastAPI मध्ये हा कोड आहे जो **प्रत्येक request आणि response** साठी चलतो — तुमच्या endpoints चे आवरण करून logging, timing, CORS आणि headers जोडणे यांसारख्या क्रॉस-कटिंग समस्यांना हाताळण्यासाठी. FastAPI Starlette च्या middleware प्रणाली (ASGI-आधारित) वापरते.

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

पद्धती: `await call_next(request)` आधीची कोड **अंदर** चलते (endpoint आधी), `call_next` endpoint ला invoke करते आणि नंतरची कोड **बाहेर** चलते (response सुधारते). हे प्रत्येक request चे आवरण करते — येथे, सर्व responses साठी timing header जोडते.

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

## Built-in / सामान्य 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 (क्रॉस-ऑरिजिन 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 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.
```

## हे महत्वाचे का आहे

Middleware हे FastAPI मध्ये **global, cross-cutting concerns** साठी योग्य यंत्रणा आहे — logic जो प्रत्येक request आणि response साठी लागू केला पाहिजे, जसे की logging, request timing, CORS, compression आणि custom headers.

याचे समज application ला बरोबर structure करण्यासाठी महत्वाचे आहे: middleware सर्व endpoints चे आवरण करते (आधी आणि नंतर चलते, request आणि response दोन्ही सुधारण्याची क्षमता असते), ज्यामुळे ते app-wide behavior साठी आदर्श आहे जो प्रत्येक endpoint मध्ये पुनरावृत्ती करणे कंटाळवाणे आणि error-prone असेल.

**Middleware** (global, raw request/response level) आणि **dependencies** (per-endpoint, parsed/typed values आणि DI मध्ये access — auth आणि validation साठी चांगले) यातील फरक जाणून घेणे हे योग्य tool निवडण्यासाठी महत्वाचे आहे.

CORS आणि compression यांसारख्या सामान्य गरजा built-in middleware द्वारे हाताळल्या जातात, तर custom middleware logging आणि instrumentation कव्हर करते — हे well-structured, observable APIs बनवण्यासाठी व्यावहारिक, वारंवार वापरले जाणारे ज्ञान आहे.