Spring Boot에서 S3에 파일을 업로드하는 세 가지 방법 | 우아한형제들 기술블로그

Stream 업로드

서버의 리소스가 한정적이고 작은 용량의 파일을 업로드할 때 효과적

• HttpServletRequest의 InputStream을 이용하여 AWS S3에 다이렉트로 파일을 전송하는 방식
• 업로드할 파일의 바이너리 전체를 Spring Boot 애플리케이션을 실행하고 있는 서버의 디스크나 힙 메모리에 저장하지 않는다는 점
• 애플리케이션 로직을 통해 모든 바이너리를 메모리에 로드하지 않는 이상 전 전처리(ex. 이미지 리사이징)가 불가능한 특징
• 1회 API 호출에 1개 파일만을 업로드 가능
• 업로드할 파일 용량이 커질수록 업로드 속도에 유의
  • 운영 환경과 동일한 인프라로 충분한 업로드 속도 테스트가 필요

고려사항

• 클라이언트 네트워크 환경, 클라우드 인스턴스 유형에 따라 업로드 속도 편차가 크기 때문에 운영환경과 동일한 인프라로 충분한 속도 테스트가 필요합니다.
• Stream 업로드 방식은 구조적으로 클라이언트에게 업로드 현황을 제공할 수 없습니다. 따라서 클라이언트가 기다릴 수 있을만큼 적당한 파일사이즈 제한이 필요합니다.
• 대용량 파일을 업로드 중 오류가 발생했을 때 전체 파일을 처음부터 다시 업로드해야하기 때문에 시간과 대역폭이 낭비될 수 있습니다.

MultipartFile 업로드

• Spring에서 제공하는 MultipartFile 인터페이스를 이용하여 파일을 업로드하는 방식
• Stream 업로드에 비해 더 높은 수준의 추상화와 편의성을 제공
• 단일 API 호출로 여러 개의 파일을 동시에 업로드 가능
• 파일 처리 속도는 더 빠르겠지만, 스레드가 작업을 수행하는 동안 부담이 될 수 있기 때문에 충분한 검토가 필요
• Stream 방식과 마찬가지로, 다수의 사용자로부터 동시에 요청이 들어올 경우, 서버의 스레드가 빠르게 소진될 위험 존재. 이에 따라 스레드 풀 설정이 적절하지 않으면 스레드 고갈로 인해 타임아웃이 발생할 위험 → 해결방안 존재