Spring Boot：上传文件大小超限制如何捕获 MaxUploadSizeExceededException 异常

最新推荐文章于 2025-06-19 17:58:23 发布

原创最新推荐文章于 2025-06-19 17:58:23 发布 · 1.1w 阅读

17 ·

CC 4.0 BY-SA版权

文章标签：

#SpringBoot

SpringBoot 专栏收录该内容

12 篇文章

订阅专栏

探讨SpringBoot中文件上传大小限制，默认为1MB单文件和10MB请求大小，超限会抛出MaxUploadSizeExceededException。文章解析不同超限情况的异常区别，及如何配置解决，包括调整spring.servlet.multipart和server.tomcat.max-swallow-size参数。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Spring Boot 默认上传文件大小限制是 1MB，默认单次请求大小是 10MB，超出大小会跑出 MaxUploadSizeExceededException 异常。

问题来了，当文件超过 1M 和超过 10M 时异常是有区别的，这也是本文所说的重点。

问题

当上传文件超过 10M 后自己写的全局异常处理@ControllerAdvice类竟然无法捕获 MaxUploadSizeExceededException 异常，页面直接 500 错误了。注册的 @ExceptionHandler(MaxUploadSizeExceededException.class) 的异常处理方法进不来。

文件超 1M 但小于 10M 时的异常信息：

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

文件超 10M 的异常信息：

Resolved [org.springframework.web.multipart.MaxUploadSizeExceededException: Maximum upload size exceeded; nested exception is java.lang.IllegalStateException: org.apache.tomcat.util.http.fileupload.FileUploadBase$SizeLimitExceededException: the request was rejected because its size (12209424) exceeds the configured maximum (10485760)]

解决方案

原文地址：https://weiku.co/article/198/

微酷在国内各网站搜了半天没发现一个真是解决问题的文章，不担心，每每此时国外网站Google一下总能找到解决方案，来自stackoverflow的解决方案，大家了解下。

spring.servlet.multipart.max-file-size = 50MB
spring.servlet.multipart.max-request-size = 50MB
server.tomcat.max-swallow-size = 100MB # 最重要的是这一行

注意上面最重要的是要配置内嵌的 tomcat 的最大吞吐量即 max-swallow-size，可以设置 -1 不限制，也可以设置一下比较大的数字这里微酷设置 100M。当上传文件超 tomcat 的大小限制后会先于 Controller 触发异常，所以这时我们的异常处理类无法捕获 Controller 层的异常。

这样当上传文件超大小限制后就可以被全局异常处理类捕获了。