SpringBoot关于文件上传超出大小限制--设置了全局异常但是没有正常捕获的情况+捕获后没有正常响应返给前端

项目背景

一个档案管理系统，在上传比较大的文件时由于系统设置的文件大小受限导致文件上传不了，这时候设置的异常捕捉未能正常报错导致前端页面一直在转圈，实际上后端早已校验完成。

全局异常类设置的捕捉

添加了@ControllerAdvice以及@RestControllerAdvice

java 复制代码

@ExceptionHandler(MaxUploadSizeExceededException.class)
@ResponseBody
public AjaxResponse handleMaxUploadSizeExceededException(MaxUploadSizeExceededException e) {
    log.error("文件上传大小超出限制", e);
    return AjaxResponse.error("上传文件过大，超出了允许的最大值");
}

文件上传的Controller方法上也添加了异常捕捉块

java 复制代码

try{
    ........//文件处理
catch (org.springframework.web.multipart.MaxUploadSizeExceededException e) {
            return AjaxResponse.error("上传文件过大，超出了允许的最大值: " + e.getMessage());
        }
}

依旧报错没有正常返回报错信息

查看报错的堆栈信息了解问题原因

1.异常发生的时机：从异常堆栈可以看出，MaxUploadSizeExceededException是在Spring MVC的请求处理早期阶段抛出的，具体是在StandardMultipartHttpServletRequest.parseRequest方法中，这发生在请求到达控制器方法之前。

异常处理流程：异常堆栈显示，异常是在Tomcat的Request.parseParts方法中首先被触发的，然后被包装成IllegalStateException，最终被Spring包MaxUploadSizeExceededException。
过滤器链干扰：从堆栈信息可以看到，请求经过了多个过滤器，包括Shiro的过滤器链（ProxiedFilterChain、AdviceFilter等）。这些过滤器可能在异常被抛出后就处理了请求，导致异常没有传递到DispatcherServlet的异常处理机制。

为什么全局异常处理器没有生效

尽管类中正确定义了处理MaxUploadSizeExceededException的方法，但它没有生效的原因可能是： 1. 异常被提前处理：异常在到达DispatcherServlet的异常处理机制之前就被处理了。从堆栈信息看，异常是在StandardMultipartHttpServletRequest.parseRequest方法中被捕获并处理的。 2. 过滤器链中断：Shiro或其他过滤器可能捕获了异常并进行了处理，阻止了异常继续传播到全局异常处理器。

请求解析阶段异常：文件上传大小超限的异常发生在请求解析阶段，这个阶段早于Spring MVC的异常处理机制被激活的时机

设置了Filter过滤器之后异常正常捕获但前端响应依旧不可行

尝试了在过滤器链中设置了最高的优先级去处理文件上传类型的错误，虽然异常是正常捕获了，但前端一直处在长时间的调用当中，并没有反馈调用信息，这个时候应该就不是SpringMVC的问题，可能发生在内置服务器或者是Http请求协议那一块，简便点说就是服务器在你捕获到这个异常之前就把这个问题处理了，虽然你后面依旧可以正常捕获，下面是打印的响应请求

java 复制代码

2025-05-30 14:23:35.129  INFO 1792  --- [http-nio-8070-exec-5]  com.yys.config.exception.WebExceptionHandler.handleMaxUploadSizeExceededException(WebExceptionHandler.java:317) : Ajax response: AjaxResponse(isok=false, code=413, message=文件大小超过限制，最大允许123123, data=null)
2025-05-30 14:23:35.130  WARN 1792  --- [http-nio-8070-exec-5]  org.springframework.web.servlet.handler.AbstractHandlerExceptionResolver.logException(AbstractHandlerExceptionResolver.java:199) : Resolved [org.springframework.web.multipart.MaxUploadSizeExceededException: Maximum upload size exceeded; nested exception is java.lang.IllegalStateException: org.apache.tomcat.util.http.fileupload.impl.FileSizeLimitExceededException: The field file exceeds its maximum permitted size of 213909504 bytes.]

SpringBoot内置服务器Tomcat参数设置

查阅一些资料之后，就可以发现Tomcat服务器对上传的文件是有要求限制的，这个配置是用来设置 Tomcat 允许接收的最大请求内容大小（包括请求头和文件内容）。当上传的文件大小超过这个值时，Tomcat 会直接丢弃超出部分并抛出异常。

设置 server.tomcat.max-swallow-size=-1 后，表示不限制请求体的大小，因此就能正确接收到超大的文件上传请求并返回相应的错误信息。

总结一下：

server.tomcat.max-swallow-size 默认情况下有一个限制，如果超出了这个限制，Tomcat 就会截断请求并返回错误。

通过设置为 -1，可以让 Tomcat 接受任意大小的请求体，确保上传过程不被中断。