SpringBoot设置文件上传大小限制后,异常捕获问题

首次发帖,希望以后和大家一起学习:
正题:之前碰到SpringBoot文件上传大小限制问题
下列是SpringBoot1.5.7的配置(其他版本有略微差别):
在这里插入图片描述
大小自己设置,图片仅供参考

这里异常处理使用SpringBoot的@RestControllerAdvice全局异常处理器
在这里插入图片描述
1.看报错信息提示是 org.springframework.web.multipart.MultipartException;
但是问题来了,这个异常有些笼统,我们并不能准确知道是单个文件大小超过限制,
还是这次请求的总文件大小超出限制(因为想准确的提示用户)。所以在异常捕获的方法中打断点,debug看方法的调用栈信息:
在这里插入图片描述
在这里插入图片描述

可见异常来源为org.springframework.web.multipart.support.StandardMultipartHttpServletRequest.parseRequest方法

并根据异常打印信息看到:org.springframework.web.multipart.MultipartException: Could not parse multipart servlet request; nested exception is java.lang.IllegalStateException: org.apache.tomcat.util.http.fileupload.FileUploadBase$SizeLimitExceededException: the request was rejected because its size (91338960) exceeds the configured maximum (1048576)
翻译:
大概翻译来说就是异常处理捕获了一个org.springframework.web.multipart.MultipartException异常,而该异常的嵌套异常(也就是引发该异常的内部异常)为java.lang.IllegalStateException:org.apache.tomcat.util.http.fileupload.FileUploadBase $ SizeLimitExceededException:由于该请求的大小(91338960)超出了配置的最大值(1048576),该请求被拒绝

然后之前我用的是exception.getCause().getCause()去获取这个嵌套了两层的异常的。但是有个替代方法exception.getRootCase()可以直接获取到引发异常的根异常(也就是异常源头)
大家使用:

 /**
     * 处理文件上传大小超限制
     * @param exception
     * @return
     */
    @ExceptionHandler(value = MultipartException.class)
    public String fileUploadExceptionHandler(MultipartException exception, HttpServletResponse response) {
        String msg;
        if (exception.getRootCause() instanceof FileUploadBase.FileSizeLimitExceededException) {
            msg="上传文件过大[单个文件大小不得超过" + maxFileSize + "]";
        }else if(exception.getRootCause() instanceof FileUploadBase.SizeLimitExceededException){
            msg="上传文件过大[总上传大小不得超过" + maxRequestSize + "]";
        }else {
            msg="文件上传失败[服务器异常]";
        }
        
        log.error(msg, exception);
        return msg;
    }

以上方式便可以捕获到异常进行提示。

注意:
(1)上传文件的时,假设单文件和总请求大小都限制为1MB,这时,你上传一个2MB(超出1MB的即可)的文件,则只会捕获到总上传大小超限异常(FileUploadBase.SizeLimitExceededException)
(2)也就是说如果总大小超限,则会优先提示总大小超限异常。在总大小未超限情况下,上传单个或多个文件时,有任何一个文件大小超过单文件大小限制,才会抛出单文件大小超限异常

附加:对于SpringBoot2.X版本,文件上传异常有所变动。如下,异常更换为org.apache.tomcat.util.http.fileupload.impl下。(在这里提示大家:主要理解这里寻找该异常捕获解决的一个思路。面对真实开发中遇到的诸如基础框架版本等一系列问题。都可能会导致本教程不适用。不过,大家应该学会,日志追踪和源码调试这些技巧。即便问题再怎么千奇百怪,也可以自己定位到问题所在。不要只是照搬代码就可以了哦!当然,我不会为你们的bug负责,哈哈哈哈)

  @ExceptionHandler(value = MultipartException.class)
    public Result fileUploadExceptionHandler(MultipartException exception, HttpServletResponse response) {
        String msg="";
        Throwable rootCase=exception.getRootCause();
        if (rootCase instanceof org.apache.tomcat.util.http.fileupload.impl.FileSizeLimitExceededException) {
            msg="上传文件过大[文件大小不得超过" + maxFileSize + "]";
        }else if(rootCase instanceof org.apache.tomcat.util.http.fileupload.impl.SizeLimitExceededException){
            msg="文件上传失败[请求字节超限]";
        }else {
            msg="上传失败[服务器异常]";
        }
        log.error(msg, exception);
        return ResponseUtil.error(ResultCodeEnum.ERROR.CODE,msg);
    }

application-xxx.yml

spring:
  servlet:
    multipart:
      max-file-size: 1GB
      max-request-size: 1GB

FileSizeLimitExceededException 单个文件超出配置max-file-size的大小限制,触发该异常
SizeLimitExceededException 总的请求字节数超过max-request-size配置的大小限制,触发该异常
希望对您有帮助

  • 9
    点赞
  • 18
    收藏
    觉得还不错? 一键收藏
  • 17
    评论
评论 17
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值