springboot文件上传超过最大长度自定义异常不生效解决方式

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

朝花不迟暮

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

阅读量3.1k

点赞数 2

CC 4.0 BY-SA版权

分类专栏： SpringBoot 文章标签： java spring boot tomcat

本文链接：https://blog.youkuaiyun.com/Curtisjia/article/details/113665201

SpringBoot 专栏收录该内容

74 篇文章

订阅专栏

该博客介绍了如何在SpringBoot中配置文件上传限制，包括通过调整`spring.servlet.multipart`属性以限制单个文件和总请求大小。当上传文件超出限制时，由于Tomcat会先抛出异常，因此需要配置`server.tomcat.max-swallow-size`以确保异常能被全局异常处理类捕获。在SpringBoot 2.0.3版本中，由于`TomcatEmbeddedServletContainerFactory`不再适用，需要使用`ServletWebServerFactory`进行相同配置。最后展示了如何创建一个全局异常处理器来处理`MultipartException`，并返回自定义错误响应。

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

springboot做文件上传如果用户上传的文件超过规定范围，控制台会提示错误，但是如果用户自定义异常拦截却拦截不到，因为这个错已经被Tomcat抛出去了，所以要解决这个问题需要对springboot内置Tomcat进行配置

spring:
	servlet:
		multipart:
      	max-request-size: 15MB #改为自己的想要的
      	max-file-size: 5MB #改为自己的想要的
      	enabled: true
server:
  tomcat:
    max-swallow-size: 100MB #重要的一行，修改tomcat的吞吐量

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

然后使用全局异常处理类来捕获异常

@RestControllerAdvice
public class GlobalExceptionHandler {

    static final Logger logger = LoggerFactory.getLogger(GlobalExceptionHandler.class);

 @ExceptionHandler(value = MultipartException.class)
    public Response handleBusinessException(MaxUploadSizeExceededException ex) {
        String msg;
        if (ex.getCause().getCause() instanceof FileUploadBase.FileSizeLimitExceededException) {
            logger.error(ex.getMessage());
            msg = "上传文件过大[单文件大小不得超过10M]";
        } else if (ex.getCause().getCause() instanceof FileUploadBase.SizeLimitExceededException) {
            logger.error(ex.getMessage());
            msg = "上传文件过大[总上传文件大小不得超过10M]";
        } else {
            msg = "上传文件失败";
        }
        return new Response("-1", msg, null);
    }
}

示例来源：https://blog.youkuaiyun.com/daweozai/article/details/103575718?utm_source=app
据实际情况进行改动！

然，我在配置的时候发现了一个问题，因为我的项目springboot版本是2.0.3，我发现他没有server.tomcat.max-swallow-size的配置，我又去查了一下说是要注入bean来进行配置：

//...
import org.apache.coyote.http11.AbstractHttp11Protocol;
import org.springframework.boot.context.embedded.tomcat.TomcatConnectorCustomizer;
import org.springframework.boot.context.embedded.tomcat.TomcatEmbeddedServletContainerFactory;
 
    private int maxUploadSizeInMb = 10 * 1024 * 1024; // 10 MB
 
    @Bean
    public TomcatEmbeddedServletContainerFactory tomcatEmbedded() {
 
        TomcatEmbeddedServletContainerFactory tomcat = new TomcatEmbeddedServletContainerFactory();
 
        tomcat.addConnectorCustomizers((TomcatConnectorCustomizer) connector -> {
		
            // connector other settings...
 
            // configure maxSwallowSize
            if ((connector.getProtocolHandler() instanceof AbstractHttp11Protocol<?>)) {
                // -1 means unlimited, accept bytes
                ((AbstractHttp11Protocol<?>) connector.getProtocolHandler()).setMaxSwallowSize(-1);
            }
			
        });
 
        return tomcat;
 
    }