FastAPI async def आणि नियमित def दोन्ही path operations साठी समर्थन करते. निवडीचा कार्यक्षमतेसाठी महत्त्व आहे: जेव्हा तुम्ही non-blocking I/O await करू शकता तेव्हा वापरा, आणि जेव्हा तुमचा कोड blocking (synchronous) operations कॉल करतो तेव्हा नियमित वापरा.
async defdef@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
महत्त्वाचा नियम: async def मध्ये कधीही blocking calls टाकू नका — हे event loop ला block करते आणि concurrency नष्ट करते. एकतर await सह async library वापरा, किंवा plain def वापरा (जे FastAPI thread pool मध्ये सुरक्षितपणे चलवते).
async def आणि def मध्ये योग्यरित्या निवड करणे तुमच्या API च्या कार्यक्षमता आणि concurrency ला थेट प्रभावित करते, आणि ते चुकवणे एक सामान्य, गंभीर त्रुटी आहे.
मुख्य अंतर्दृष्टी अशी आहे की async def हे फक्त तेव्हाच फायदेशीर आहे जेव्हा तुम्ही non-blocking operations await कराल — blocking call (जसे synchronous requests library किंवा blocking database driver) async def मध्ये टाकल्यास संपूर्ण event loop ला block करते, सर्व concurrent requests फ्रीজ करते आणि async चा उद्देश नष्ट करते.
उलट, FastAPI हुशारीपणे plain def endpoints thread pool मध्ये चलवते, त्यामुळे synchronous/blocking कोड तेथे सुरक्षित आहे.
हा नियम समजणे — async def साच्या async libraries सह वापरा, blocking कोडसाठी plain def वापरा, आणि blocking calls ला async def मध्ये कधीही मिक्स करू नका — हे performant FastAPI endpoints लिहिण्यासाठी आवश्यक आहे आणि accidentally एक block केलेल्या event loop मागे सर्व requests serialize करण्याची सूक्ष्म पण विनाशकारी त्रुटी टाळण्यासाठी आवश्यक आहे.