FastAPI unterstützt sowohl async def als auch reguläres def für Path Operations. Die Wahl beeinflusst die Leistung: Verwenden Sie async def, wenn Sie nicht-blockierende I/O mit verwenden können, und reguläres , wenn Ihr Code blockierende (synchrone) Operationen aufruft.
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
Die kritische Regel: Setzen Sie niemals blockierende Aufrufe in async def — das blockiert die Event Loop und zerstört Concurrency. Verwenden Sie entweder eine asynchrone Bibliothek mit await, oder verwenden Sie einfach def (das FastAPI sicher in einem Thread Pool ausführt).
Die richtige Wahl zwischen async def und def beeinflusst direkt die Leistung und Concurrency Ihrer API. Die falsche Wahl ist ein häufiger, ernster Fehler.
Die Schlüsseleinsicht ist, dass async def nur dann sinnvoll ist, wenn Sie nicht-blockierende Operationen mit await verwenden — wenn Sie einen blockierenden Aufruf (wie die synchrone requests-Bibliothek oder einen blockierenden Datenbanktreiber) in ein async def setzen, blockiert das die gesamte Event Loop, friert alle gleichzeitigen Anfragen ein und macht den Zweck von Async zunichte.
Umgekehrt führt FastAPI geschickt einfache def Endpoints in einem Thread Pool aus, sodass synchroner/blockierender Code dort sicher ist.
Diese Regel zu verstehen — verwenden Sie async def mit wirklich asynchronen Bibliotheken, verwenden Sie einfaches def für blockierenden Code, und mischen Sie niemals blockierende Aufrufe in async def — ist essentiell, um performante FastAPI-Endpoints zu schreiben und den subtilen, aber verheerenden Fehler zu vermeiden, versehentlich alle Anfragen hinter einer blockierten Event Loop zu serialisieren.