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

此文章发布于 59 个月前,部分信息可能已经过时,请自行斟酌确认。

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)]

解决方案

微酷在国内各网站搜了半天没发现一个真是解决问题的文章,不担心,每每此时国外网站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 层的异常。

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

参考文档

https://stackoverflow.com/questions/2689989/how-to-handle-maxuploadsizeexceededexception

最后修改:2019 年 05 月 13 日 02 : 45 PM
如果觉得我的文章对你有用,请随意赞赏

4 条评论

  1. hehe

    当>100M呢?并没有解决问题额。怎么捕获tomcat异常并返回给前端

    1. ifu25
      @hehe

      文中设置的100M是个人喜好,你可以设置其它的数值。

      1. chen
        @ifu25

        他的意思是,如果超过了100M,如何捕获tomcat抛出的这个异常

        1. ifu25
          @chen

          文中只是举例设置为100M,文中也提到不想限制可以设置为-1,这样就可以捕获异常了。
          当然非要想捕获tomcat抛出的异常,这个我没再深入研究。

发表评论 取消回复