[Trouble Shooting] MaxUploadSizeExceededException

개발 환경

• Build : Gradle
• SpringBoot :  2.7.5
• Java : 11
• OS : Mac

발생

포스트맨으로 form-data 이미지 파일을 POST 요청을 보냈을 때 다음과 같은 에러가 발생했다.

org.springframework.web.multipart.MaxUploadSizeExceededException: Maximum upload size exceeded; nested exception is java.lang.IllegalStateException: org.apache.tomcat.util.http.fileupload.impl.FileSizeLimitExceededException: The field image exceeds its maximum permitted size of 1048576 bytes.

원인

에러 메세지에서도 알 수 있듯이 스프링에서 파일 업로드는 1MB로 기본 설정이 되어 있는 듯 하다.

따라서 1MB를 초과하는 파일을 받기 위해서는 따로 설정을 해야 한다고 한다.

해결

max-file-size : 파일 하나당 크기

max-request-size : 요청할 때 파일의 총 크기

방법 1. Spring Boot 2.x.x

# application.properties
spring.servlet.multipart.max-file-size= 10MB
spring.servlet.multipart.max-request-size= 10MB

# application.yml
spring:
  servlet:
    multipart:
      max-file-size: 10MB
      max-request-size: 10MB

방법 2. Spring Boot 1.4.x ~ 1.5.x

# application.properties
spring.http.multipart.max-file-size= 10MB
spring.http.multipart.max-request-size= 10MB

# application.yml
spring:
  http:
    multipart:
      max-file-size: 10MB
      max-request-size: 10MB

방법 3. Spring Boot x.x.x ~ 1.3.x

# application.properties
multipart.max-file-size= 10MB
multipart.max-request-size= 10MB

# application.yml
multipart:
  max-file-size: 10MB
  max-request-size: 10MB

테스트

정상적으로 응답이 오는 것을 확인할 수 있다!

---

Reference

https://server0.tistory.com/41

Spring Boot, 파일 업로드 용량 설정

https://stackoverflow.com/questions/37540028/how-to-set-the-max-size-of-upload-file/48428279#48428279

How to set the max size of upload file