spring boot 全局异常处理无法直接捕获请求体过大异常,因为该异常发生在请求解析阶段,尚未到达 controller 层的异常处理器。要解决这个问题,需要配置自定义的 errorcontroller 或使用 handlerexceptionresolver 来拦截底层 servlet 容器抛出的错误。

为什么标准 @ExceptionHandler 无效
在 Spring MVC 中,@RestControllerAdvice 和 @ExceptionHandler 只能处理由 DispatcherServlet 分发给 Controller 后抛出的异常。当请求体超过 max-in-memory-size 或 max-file-size 限制时,Tomcat、Jetty 等嵌入式容器会在请求被解析前直接拒绝连接,并抛出 IllegalStateException 或 MaxUploadSizeExceededException(如果使用了 CommonsMultipartResolver)。由于请求从未成功进入 Spring MVC 的处理链,标准的异常处理器无法捕获这些错误。

import org.springframework.boot.web.servlet.error.ErrorController;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import org.springframework.web.multipart.MaxUploadSizeExceededException;
@RestControllerAdvice
public class GlobalExceptionHandler {
// 这个处理器通常无法捕获请求体过大的异常
@ExceptionHandler(MaxUploadSizeExceededException.class)
public ResponseEntity<String> handleMaxSizeException(MaxUploadSizeExceededException ex) {
return ResponseEntity.status(HttpStatus.PAYLOAD_TOO_LARGE).body("File too large");
}
}
上述代码展示了常见的全局异常处理类,但请注意,对于上传文件过大导致的 MaxUploadSizeExceededException,只有在请求成功通过 Servlet 容器的初步检查并进入 Spring 的 MultipartResolver 阶段时才会被触发。如果容器层面直接拒绝,则此方法失效。
如何正确捕获并处理请求体过大
为了捕获请求体过大异常,最可靠的方法是实现一个自定义的 ErrorController 或者注册一个 HandlerExceptionResolver。推荐使用 ErrorController 的方式,因为它能更好地与 Spring Boot 的错误处理机制集成。我们需要创建一个类实现 ErrorController 接口,并重写 getErrorPath 方法,然后在其中处理具体的异常逻辑。

import org.springframework.boot.web.servlet.error.ErrorController;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.context.request.WebRequest;
@Controller
public class CustomErrorController implements ErrorController {
@RequestMapping("/error")
public ResponseEntity<String> handleError(WebRequest request) {
Throwable throwable = (Throwable) request.getAttribute("javax.servlet.error.exception", 0);
if (throwable instanceof IllegalStateException && throwable.getMessage().contains("Maximum upload size exceeded")) {
return ResponseEntity.status(HttpStatus.PAYLOAD_TOO_LARGE).body("Request body too large");
}
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("Internal Server Error");
}
public String getErrorPath() {
return "/error";
}
}
在这个示例中,我们创建了一个 CustomErrorController,它实现了 ErrorController 接口。当发生错误时,Spring Boot 会调用 /error 端点。我们通过获取请求属性中的异常对象,判断是否为“最大上传大小超出”的异常,并返回相应的 HTTP 状态码和消息。这种方式确保了即使请求在早期阶段被拒绝,也能得到统一的错误响应。
基于 max-in-memory-size 配置的具体问题
在实际开发中,请求体过大往往与 server.servlet.max-in-memory-size 或 spring.servlet.multipart.max-file-size 配置相关。如果未正确配置这些参数,默认值可能导致意外的大请求被截断或拒绝。例如,如果 max-in-memory-size 设置为 2MB,而客户端发送了 3MB 的请求体,Tomcat 可能会直接关闭连接,导致客户端收到 500 Internal Server Error 或 413 Payload Too Large。因此,确保在 application.yml 中明确设置这些限制,并结合上述 ErrorController 进行统一处理,是解决此类问题的关键步骤。


















