首次发帖,希望以后和大家一起学习:
正题:之前碰到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配置的大小限制,触发该异常
希望对您有帮助