A FastAPI támogatja az async def és a sima def alkalmazást is az útműveleteknél. A választás fontos a teljesítmény szempontjából: használjon async def-et, ha nem blokkoló I/O-t -elheti, és sima -et, ha a kód blokkoló (szinkron) műveletekeit hívja.
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
A kritikus szabály: soha ne helyezz blokkoló hívásokat async def-be — ez blokkolja az event loop-ot és megsemmisíti az párhuzamosságot. Vagy használj async könyvtárat az await-tel, vagy sima def-et (amit a FastAPI biztonságosan futtat egy szál medencében).
A helyes választás az async def és a def között közvetlenül befolyásolja az API teljesítményét és párhuzamosságát, és a helytelen választás egy gyakori, súlyos hiba.
A kulcsfontosságú felismerés az, hogy az async def csak akkor előnyös, ha nem blokkoló műveletekat await-elsz — a blokkoló hívás (mint a szinkron requests könyvtár vagy a blokkoló adatbázis-illesztőprogram) async def-be helyezése az egész event loop-ot blokkolja, befagyasztja az összes egyidejű kérést és megsemmisíti az aszinkron célját.
Ezzel szemben a FastAPI okosan futtatja a sima def endpoint-okat egy szál medencében, így a szinkron/blokkoló kód ott biztonságos.
E szabály megértése — async def-et használj valódi async könyvtárakkal, sima def-et blokkoló kódhoz, és soha ne keverj blokkoló hívásokat async def-be — elengedhetetlen a teljesítményes FastAPI endpoint-ok írásához és az összes kérés véletlenül blokkolt event loop mögé való sorba rendezésének apró, de katasztrofális hibájának elkerüléséhez.