Το FastAPI υποστηρίζει τόσο async def όσο και κανονικό def για path operations. Η επιλογή έχει σημασία για την απόδοση: χρησιμοποιήστε async def όταν μπορείτε να κάνετε σε non-blocking I/O, και κανονικό όταν ο κώδικάς σας καλεί blocking (synchronous) operations.
awaitdef@app.get("/async")
async def async_endpoint():
data = await fetch_from_api() # await non-blocking I/O — efficient
return data
@app.get("/sync")
def sync_endpoint():
data = blocking_db_call() # ordinary blocking code
return data
async def → runs on the main event loop. Efficient ONLY if you await non-blocking calls.
⚠️ A BLOCKING call inside async def blocks the WHOLE event loop → kills concurrency!
def → FastAPI runs it in a THREAD POOL, so blocking code doesn't block the event loop.
Safe for synchronous/blocking libraries.
# ✅ async def — when you can await async libraries (httpx, async DB drivers)
async def get_user():
async with httpx.AsyncClient() as c:
return await c.get(url)
# ✅ plain def — when using SYNCHRONOUS/blocking libraries (requests, sync ORM)
def get_user():
return requests.get(url).json() # blocking → FastAPI runs it in a thread
# ❌ THE DANGEROUS MISTAKE — blocking call inside async def
async def bad():
return requests.get(url).json() # blocks the event loop! Use `def` or an async client
Ο κρίσιμος κανόνας: ποτέ μην τοποθετείτε blocking calls σε async def — αποκλείει το event loop και καταστρέφει τη συνδρομητικότητα. Είτε χρησιμοποιήστε μια async βιβλιοθήκη με await, είτε χρησιμοποιήστε plain def (το οποίο το FastAPI εκτελεί με ασφάλεια σε thread pool).
Η σωστή επιλογή μεταξύ async def και def επηρεάζει απευθείας την απόδοση και τη συνδρομητικότητα του API σας, και η λάθος επιλογή είναι ένα κοινό, σοβαρό λάθος.
Η βασική ιδέα είναι ότι async def είναι ωφέλιμο μόνο όταν περιμένετε non-blocking operations — η τοποθέτηση ενός blocking call (όπως η synchronous βιβλιοθήκη requests ή ένας blocking database driver) μέσα σε async def αποκλείει ολόκληρο το event loop, παγώνοντας όλα τα concurrent requests και αναιρώντας τον σκοπό του async.
Αντίθετα, το FastAPI εκτελεί έξυπνα plain def endpoints σε thread pool, οπότε ο synchronous/blocking κώδικας είναι ασφαλής εκεί.
Η κατανόηση αυτού του κανόνα — χρησιμοποιήστε async def με truly async βιβλιοθήκες, χρησιμοποιήστε plain def για blocking κώδικα, και ποτέ μην συνδυάζετε blocking calls σε async def — είναι απαραίτητη για την εγγραφή performant FastAPI endpoints και την αποφυγή του λεπτού αλλά καταστροφικού λάθους της τυχαίας σειριοποίησης όλων των requests πίσω από ένα blocked event loop.