📌 Spring 파일 업로드 & 다운로드 완전 정복

📅 날짜

2025-04-28

---

📝 학습 내용

1️⃣ 파일 업로드 & 다운로드 개요

• 웹 애플리케이션에서 파일 업로드란 사용자가 서버로 파일을 전송하는 과정.
• 파일 다운로드는 서버에 저장된 파일을 사용자에게 다시 전송하는 과정.
• 주로 사용하는 형식: multipart/form-data
• HTTP 메서드:
  • 업로드 ➡️ POST
  • 다운로드 ➡️ GET

---

2️⃣ 업로드를 위한 환경 준비

✅ pom.xml 의존성 설정

파일 업로드를 위해 Apache Commons 라이브러리를 사용합니다.

<!-- 파일 업로드 지원 (commons-fileupload, commons-io) -->
<dependency>
    <groupId>commons-fileupload</groupId>
    <artifactId>commons-fileupload</artifactId>
    <version>1.4</version>
</dependency>

<dependency>
    <groupId>commons-io</groupId>
    <artifactId>commons-io</artifactId>
    <version>2.8.0</version>
</dependency>

---

3️⃣ Java Config 설정 (WebMvcConfig)

✅ servlet-context.xml을 대체하는 설정 클래스

• 파일 업로드를 위한 MultipartResolver 빈 등록
• ViewResolver 설정
• 정적 리소스 경로 매핑

@Bean
public MultipartResolver multipartResolver() {
    CommonsMultipartResolver multipartResolver = new CommonsMultipartResolver();
    multipartResolver.setMaxUploadSize(20971520); 			// 20MB
    multipartResolver.setMaxUploadSizePerFile(20971520); 	// 20MB
    multipartResolver.setMaxInMemorySize(20971520); 		// 20MB
    return multipartResolver;
}

---

4️⃣ JSP 파일 업로드 폼 구현

✅ multipart/form-data 설정 필수

<form action="${pageContext.request.contextPath }/file/upload" method="post" enctype="multipart/form-data">
	<input type="file" name="files" multiple/>
	<button>전송</button>
</form>

---

5️⃣ 파일 업로드 컨트롤러 구현

✅ 공통 업로드 로직 (메서드 분리 예시)

반복되는 폴더 생성 및 저장 로직은 메서드로 분리하는 것이 유지보수에 유리합니다.

private String createUploadFolder() {
	LocalDateTime now = LocalDateTime.now();
	String folderName = now.format(DateTimeFormatter.ofPattern("yyyyMMdd_HHmmss"));
	String path = ROOT_PATH + File.separator + UPLOAD_PATH + File.separator + folderName + File.separator;
	File dir = new File(path);
	if (!dir.exists()) dir.mkdirs();
	return path;
}

private void saveFiles(MultipartFile[] files, String path) {
	for (MultipartFile file : files) {
		try {
			File fileObject = new File(path, file.getOriginalFilename());
			file.transferTo(fileObject);
		} catch (IOException e) {
			log.error("파일 저장 실패: " + file.getOriginalFilename(), e);
		}
	}
}

✅ 기본 업로드 처리

@PostMapping("/upload")
public String upload(@RequestParam("files") MultipartFile[] files) {
	String path = createUploadFolder();
	saveFiles(files, path);
	return "file/upload";
}

✅ DTO 기반 업로드 처리

@PostMapping("/upload_dto")
public String upload_dto(FileDto dto) {
	String path = createUploadFolder();
	saveFiles(dto.getFiles(), path);
	return "file/upload";
}

---

🔥 정리

• 파일 업로드 시 반드시 multipart/form-data와 MultipartResolver 설정 필요.
• 동적 폴더 생성으로 파일 관리 체계화.
• 컨트롤러에 집중된 로직은 서비스 계층으로 분리하여 유지보수성을 높이자.
• 업로드 파일명 충돌 방지를 위해 UUID를 활용하는 것이 안전.
• 파일 확장자 및 크기 제한을 통해 보안 취약점 예방.
• 예외 처리와 업로드 후 사용자에게 적절한 응답 페이지 제공 고려.
• DTO 활용 시 폼 데이터 관리가 더 깔끔하고 확장성이 높아짐.

✨ 다운로드 기능은 다음 포스팅에서 자세히 다루겠습니다!

---

🔗 참고 자료

• Spring 공식 문서 - 파일 업로드
• Apache Commons FileUpload
• Apache Commons IO

---