엔드포인트에 async def와 def 중 무엇을 언제 사용해야 합니까?

@app.get("/async")
async def async_endpoint():
    data = await fetch_from_api()        # 논블로킹 I/O를 await — 효율적
    return data

@app.get("/sync")
def sync_endpoint():
    data = blocking_db_call()             # 일반적인 블로킹 코드
    return data

async def → 메인 이벤트 루프에서 실행. 논블로킹 호출을 await할 때만 효율적.
            ⚠️ async def 내부의 블로킹 호출은 전체 이벤트 루프를 막아 → 동시성을 무력화!
def       → FastAPI가 스레드 풀에서 실행하므로, 블로킹 코드가 이벤트 루프를 막지 않음.
            동기/블로킹 라이브러리에 안전함.

# ✅ async def — async 라이브러리(httpx, async DB 드라이버)를 await할 수 있을 때
async def get_user():
    async with httpx.AsyncClient() as c:
        return await c.get(url)

# ✅ 일반 def — 동기/블로킹 라이브러리(requests, 동기 ORM)를 사용할 때
def get_user():
    return requests.get(url).json()       # 블로킹 → FastAPI가 스레드에서 실행

# ❌ 위험한 실수 — async def 내부의 블로킹 호출
async def bad():
    return requests.get(url).json()       # 이벤트 루프를 막음! def 또는 async 클라이언트 사용