Spring에서 파일 업로드는 어떻게 구현하나요?

[dnjs0]

📷

[dnjs0]

🎤 Q. Spring에서 파일 업로드는 어떻게 처리되나요?

Spring에서는 MultipartFile 인터페이스를 사용하여 파일 업로드를 처리합니다.
클라이언트가 HTML form을 통해 multipart/form-data 형식으로 파일을 전송하면,
Controller에서는 @RequestParam 또는 @ModelAttribute를 통해 MultipartFile 객체를 받을 수 있습니다.

---

✅ 기본 흐름

1. HTML form에서 enctype="multipart/form-data" 설정
2. Controller에서 MultipartFile로 파일을 받음
3. transferTo() 메서드를 통해 서버에 저장
4. 파일명 충돌 방지를 위해 UUID 등을 활용
5. 저장한 파일의 경로나 이름을 DB에 저장

---

✅ 실습 예시

HTML

<form method="post" enctype="multipart/form-data" action="/upload">
  <input type="file" name="file"/>
  <input type="submit" value="업로드"/>
</form>

Controller

@PostMapping("/upload")
public String upload(@RequestParam("file") MultipartFile file) throws IOException {
    String savedName = UUID.randomUUID() + "_" + file.getOriginalFilename();
    Path savePath = Paths.get("C:/upload/" + savedName);
    file.transferTo(savePath.toFile());
    return "uploadSuccess";
}

✅ 파일명 중복 방지

• UUID.randomUUID()를 활용해 고유한 이름 부여
• 파일명 충돌 방지 및 보안성 확보

✅ 설정 예시 (application.properties)

spring.servlet.multipart.enabled=true
spring.servlet.multipart.max-file-size=10MB
spring.servlet.multipart.max-request-size=20MB

✅ 보안 고려사항

• .jsp, .exe, .sh 등 위험 확장자 업로드 차단
• 업로드 경로는 외부에서 접근 불가한 경로로 설정
• 이미지 등 파일 노출 시 별도의 컨트롤러를 통해 제공
• 업로드 용량 제한 설정

✅ 추가 팁

• 폼 데이터와 파일을 같이 받을 경우 @ModelAttribute 사용
• DB에 파일을 직접 저장하기보다는 파일 경로만 저장하는 것이 일반적
• 썸네일 생성 등 후처리는 별도 라이브러리 사용 가능 (예: Thumbnailator)

📌 이처럼 Spring에서는 MultipartFile을 활용한 파일 업로드를 구조적으로 처리하며, 보안과 확장성까지 고려한 설계가 중요합니다.