FastAPI menyokong kedua-dua async def dan def biasa untuk operasi laluan. Pilihan ini penting untuk prestasi: gunakan async def apabila anda boleh I/O tidak menyekat (non-blocking), dan biasa apabila kod anda memanggil operasi menyekat (segerak/synchronous).
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
Peraturan kritikal: jangan sekali-kali meletakkan panggilan menyekat dalam async def — ia menyekat gelung peristiwa (event loop) dan memusnahkan keselarasan (concurrency). Sama ada gunakan pustaka async dengan await, atau gunakan def biasa (yang FastAPI jalankan dengan selamat dalam kumpulan benang/thread pool).
Memilih dengan betul antara async def dan def secara langsung mempengaruhi prestasi dan keselarasan API anda, dan tersilap memilihnya adalah kesilapan biasa yang serius.
Wawasan utama ialah async def hanya berfaedah apabila anda await operasi tidak menyekat — meletakkan panggilan menyekat (seperti pustaka segerak requests atau pemacu pangkalan data yang menyekat) di dalam async def menyekat keseluruhan gelung peristiwa, membekukan semua permintaan serentak dan menggagalkan tujuan async.
Sebaliknya, FastAPI dengan bijak menjalankan endpoint def biasa dalam kumpulan benang (thread pool), jadi kod segerak/menyekat adalah selamat di situ.
Memahami peraturan ini — gunakan async def dengan pustaka yang benar-benar async, gunakan def biasa untuk kod menyekat, dan jangan sekali-kali mencampurkan panggilan menyekat ke dalam async def — adalah penting untuk menulis endpoint FastAPI yang berprestasi dan mengelakkan kesilapan halus tetapi memusnahkan iaitu secara tidak sengaja mensirikan semua permintaan di belakang gelung peristiwa yang tersekat.