FastAPI BackgroundTasks: 비동기 작업으로 API 응답 속도 향상시키기

핵심 기술

이 콘텐츠는 FastAPI의 BackgroundTasks 기능을 활용하여 API 요청의 응답 시간을 단축하고 사용자 경험을 향상시키는 방법을 안내합니다. 이메일 발송이나 로깅과 같이 즉각적인 응답이 필요하지 않은 작업을 백그라운드에서 처리하여 API 서버의 효율성을 높이는 것이 핵심입니다.

기술적 세부사항

• BackgroundTasks 소개: 사용자 응답을 차단하지 않고 이메일 발송, 로깅, 이미지 처리 등 백그라운드에서 실행해야 하는 작업을 처리하는 FastAPI의 기능입니다.
• 사용 방법: FastAPI 애플리케이션에서 BackgroundTasks를 DI(Dependency Injection)로 주입받아 사용합니다. background_tasks.add_task() 메서드를 통해 실행할 함수와 인자를 전달하여 백그라운드 작업을 등록합니다.
• 코드 예제: /send-email/ POST 엔드포인트를 통해 이메일 수신자 및 메시지를 받아, log_email 함수를 백그라운드 작업으로 등록하는 예시를 제공합니다. 이 예제는 파일에 로그를 기록하는 방식으로 이메일 발송을 시뮬레이션합니다.
• 실행 및 테스트: uvicorn을 사용하여 FastAPI 애플리케이션을 실행하고, Swagger UI (/docs)를 통해 /send-email/ 엔드포인트를 테스트하는 방법을 설명합니다. API 호출 후 파일에 로그가 정상적으로 기록되는지 확인하는 과정을 포함합니다.
• 실제 사용 사례: 환영 이메일, 비밀번호 재설정, 송장 발행, 사용자 활동 로깅, 이미지 크기 조정 및 압축, 바이러스 스캔, 보고서 생성 및 전송 등 다양한 실제 운영 환경에서의 활용 방안을 제시합니다.
• 주의사항 및 대안: BackgroundTasks는 짧고 가벼우며 블로킹되지 않는 작업에 적합하며, CPU 집약적이거나 시간이 오래 걸리거나 재시도 및 영속성이 필요한 작업에는 Celery, RQ, Django-Q 또는 AWS Lambda + SQS/EventBridge와 같은 전용 작업 큐 시스템 사용을 권장합니다.

개발 임팩트

• API 응답 시간을 대폭 단축하여 사용자 경험을 개선합니다.
• 장시간 소요되는 작업을 백그라운드로 분리하여 서버의 동시 처리 능력을 향상시킵니다.
• 애플리케이션의 확장성과 안정성을 높이는 데 기여합니다.

커뮤니티 반응

본문은 FastAPI의 창시자인 Sebastián Ramírez의 공식 문서를 참고하여 작성되었음을 명시하고 있으며, 독자들에게 피드백과 질문을 장려하며 커뮤니티 참여를 독려하고 있습니다.