Πώς λειτουργεί ο κύκλος ζωής ενός request στο FastAPI;

Question

IT Interview Practice · Accepted Answer

Το FastAPI τρέχει πάνω σε **ASGI**, οπότε ένα request διασχίζει ένα ασύγχρονο pipeline: ο ASGI server το δέχεται, το middleware το τυλίγει, ο router αντιστοιχίζει ένα path, **οι dependencies επιλύονται**, εκτελείται η δική σου path operation, και η επιστρεφόμενη τιμή σειριοποιείται στην απόκριση.

## Τα στάδια

```
uvicorn (ASGI server)
   │  scope + receive/send
   ▼
ASGI / Starlette middleware  ── (CORS, GZip, custom)
   ▼
Routing  ── αντιστοίχιση method + path → path operation
   ▼
Dependencies (Depends)  ── επίλυση sub-deps, security, yield-setup
   ▼
Path operation function  ── τρέχει ο handler σου
   ▼
Response model  ── validate + σειριοποίηση σε JSON
   ▼
Background tasks  ── τρέχει αφού σταλεί η απόκριση
   ▼
Response ──▶ client
```

1. **ASGI server** (uvicorn/hypercorn) δέχεται τη σύνδεση και περνά στην εφαρμογή ένα `scope` καθώς και τα callables `receive`/`send`.
2. **Middleware** τρέχει από έξω προς τα μέσα κατά την είσοδο και από μέσα προς τα έξω κατά την έξοδο (`BaseHTTPMiddleware` ή καθαρό ASGI middleware). Εδώ ζουν τα CORS, GZip και το προσαρμοσμένο timing.
3. **Routing** αντιστοιχίζει την HTTP method + το path σε μια path operation· οι παράμετροι path/query/body εξάγονται και επικυρώνονται από το **Pydantic**.
4. **Dependency injection** — το `Depends(...)` επιλύει κάθε dependency (DB session, τρέχων χρήστης, settings), με caching εντός του request. Μια dependency με `yield` εκτελεί το setup πριν και το teardown μετά τον handler.
5. **Path operation** — η `async def` σου (ή `def`, που τρέχει σε threadpool) εκτελεί την επιχειρησιακή λογική.
6. **Απόκριση** — η επιστρεφόμενη τιμή προσαρμόζεται στο δηλωμένο `response_model`, επικυρώνεται και σειριοποιείται σε JSON· εφαρμόζονται status code και headers.
7. **Background tasks** που καταχωρούνται μέσω `BackgroundTasks` τρέχουν *αφού* σταλεί η απόκριση.

```python
from fastapi import FastAPI, Depends, Request

app = FastAPI()

@app.middleware("http")
async def timing(request: Request, call_next):   # 2. middleware
    response = await call_next(request)
    response.headers["X-Time"] = "..."
    return response

async def get_db():                               # 4. dependency (yield)
    db = Session()
    try:
        yield db
    finally:
        db.close()

@app.get("/items/{id}")                           # 3. routing
async def read_item(id: int, db=Depends(get_db)): # 5. handler
    return db.get(Item, id)                        # 6. σειριοποίηση μέσω response_model
```

Οι εξαιρέσεις πιάνονται από **exception handlers** (`@app.exception_handler(...)` / `HTTPException`), που τις μετατρέπουν σε αποκρίσεις αντί να καταρρεύσει το request.

## Γιατί έχει σημασία

Ο κύκλος ζωής του request είναι εκεί όπου συμβαίνουν στην πράξη τα κορυφαία χαρακτηριστικά του FastAPI: το ασύγχρονο I/O, η επικύρωση με Pydantic και το dependency injection συνδέονται όλα σε συγκεκριμένα στάδια. Το να γνωρίζεις τη σειρά — middleware, μετά routing, μετά dependencies, μετά handler, μετά σειριοποίηση — σου επιτρέπει να τοποθετείς τη διατμηματική λογική στο σωστό σημείο (auth ως dependency, timing ως middleware, cleanup σε μια dependency με `yield`), να εντοπίζεις γιατί ένα σφάλμα validation ή auth πυροδοτείται πριν τρέξει ο κώδικάς σου, και να αποφεύγεις το μπλοκάρισμα του event loop μέσα σε έναν ασύγχρονο handler.

Τα στάδια

Γιατί έχει σημασία

Σχετικές ερωτήσεις