StreamingResponse

핵심 아이디어

StreamingResponse는 FastAPI에서 사용하는 Starlette 응답 클래스로, 이터러블이나 비동기 이터러블이 만들어 내는 바이트를 청크 단위로 바로 HTTP 본문에 흘려보냅니다. Server-Sent Events 같은 장시간 연결, 대용량 다운로드, 실시간 로그 출력에서 전체 결과를 버퍼링하지 않고도 즉시 데이터를 보낼 수 있습니다.

이 블로그에서의 역할

Mathbong FastAPI 시리즈에서는 StreamingResponse를 통해 긴 연산 과정도 스트림으로 쪼개 사용자 경험을 지키는 패턴을 배웁니다. BackgroundTasks와 조합하면 서버는 keep-alive 타임아웃(keep-alive timeout)을 지키면서도 후속 처리를 분리해 더 안정적인 API를 설계할 수 있습니다.