spring boot 全局异常处理无法直接捕获缓冲区溢出异常,因为该异常发生在 jvm 堆外内存或操作系统层面,会导致进程直接崩溃。要解决此问题,必须通过限制请求体大小来预防,具体做法是在 application.yml 中配置 spring.servlet.multipart.max-file-size 和 max-request-size 参数。

为什么全局异常处理无法捕获缓冲区溢出异常
全局异常处理器(如 @ControllerAdvice)只能拦截在 Servlet 容器内部抛出的 Java 异常。当上传文件超过服务器允许的大小时,Tomcat 等容器会在解析请求阶段就拒绝连接,并抛出 IllegalStateException 或直接终止连接,这通常不会触发 Spring MVC 的异常映射机制,而是表现为 HTTP 500 错误或连接重置。

server:
servlet:
max-http-header-size: 8KB
spring:
servlet:
multipart:
max-file-size: 10MB
max-request-size: 10MB
上述配置将单个文件和总请求体限制为 10MB。如果客户端发送的文件超过此限制,Tomcat 会立即拒绝请求,返回 400 或 500 错误,而不会进入 Spring 的业务逻辑层,从而避免了内存溢出导致的进程崩溃。
如何验证配置生效及错误表现
验证配置是否生效的最直接方式是观察请求被拒绝时的行为。当请求体超过 max-request-size 时,Tomcat 会抛出 org.apache.tomcat.util.http.fileupload.FileUploadBase$SizeLimitExceededException。虽然这个异常有时能被 @ControllerAdvice 捕获,但更常见的情况是底层连接器直接关闭连接,导致前端收到网络错误。

import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;
@RestController
public class UploadController {
@PostMapping("/upload")
public String upload(@RequestParam("file") MultipartFile file) {
return "Success";
}
}
配合前文的 YAML 配置,当用户上传一个 11MB 的文件时,请求在到达 upload 方法之前就会被拦截。此时,浏览器控制台通常会显示 Failed to load resource: the server responded with a status of 500 或类似的网络错误,而不是业务逻辑中的异常信息。这表明预防措施已在底层生效,保护了应用免受缓冲区溢出的影响。
基于请求体大小限制的具体问题
在实际开发中,开发者常遇到的问题是:即使配置了全局异常处理,大文件上传依然导致服务不可用。这是因为缓冲区溢出往往伴随着 OutOfMemoryError,这种错误是 JVM 级别的,无法被普通的 try-catch 或 @ExceptionHandler 捕获。因此,唯一的解决方案是在数据进入应用逻辑之前进行硬性限制。











