Springboot接口接受文件超过Tomcat大小限制出现异常，应该怎样捕获？

最新推荐文章于 2025-06-26 18:07:08 发布

Sinosecu-OCR

最新推荐文章于 2025-06-26 18:07:08 发布

阅读量929

点赞数 10

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/sinosecuocr/article/details/148771839

在 Spring Boot 中，Tomcat 的默认上传文件大小限制通常为 2MB。如果上传的文件超过这个限制，Tomcat 会抛出一个 org.apache.tomcat.util.http.fileupload.FileUploadException 异常。你可以通过以下几种方式来捕获并处理这个异常：

1. 配置 `application.properties` 或 `application.yml`

首先，你可以通过在 application.properties 或 application.yml 文件中配置文件上传大小限制：

properties

spring.servlet.multipart.max-file-size=10MB spring.servlet.multipart.max-request-size=10MB

或者在 application.yml 文件中：

yaml

spring: servlet: multipart: max-file-size: 10MB max-request-size: 10MB

这些设置会确保 Spring Boot 正常接收大文件。如果文件仍然超过设置的限制，Tomcat 会抛出异常。你需要捕获这个异常。

2. 捕获文件上传异常

你可以使用 Spring Boot 提供的 @ExceptionHandler 注解来捕获文件上传相关的异常。假设你有一个文件上传的接口，下面是一个示例：

java

import org.apache.tomcat.util.http.fileupload.FileUploadException; import org.springframework.http.HttpStatus; import org.springframework.ui.Model; import org.springframework.web.bind.annotation.ExceptionHandler; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; import org.springframework.web.multipart.MultipartFile; @RestController public class FileUploadController { @RequestMapping("/upload") public String uploadFile(MultipartFile file) { // 你的上传逻辑 return "File uploaded successfully!"; } @ExceptionHandler(FileUploadException.class) public String handleFileUploadException(FileUploadException ex, Model model) { model.addAttribute("message", "File size exceeds the maximum limit."); return "error"; // 返回错误页面或 JSON 错误信息 } }

3. 自定义异常处理

你可以通过全局异常处理器来处理所有上传文件的异常。比如：

java

import org.apache.tomcat.util.http.fileupload.FileUploadException; import org.springframework.http.HttpStatus; import org.springframework.web.bind.annotation.ControllerAdvice; import org.springframework.web.bind.annotation.ExceptionHandler; import org.springframework.web.bind.annotation.ResponseStatus; @ControllerAdvice public class GlobalExceptionHandler { @ExceptionHandler(FileUploadException.class) @ResponseStatus(HttpStatus.BAD_REQUEST) public String handleFileUploadException(FileUploadException ex) { return "File size exceeds the maximum allowed limit."; } }

4. 捕获 `MaxUploadSizeExceededException`

Spring Boot 也提供了 MaxUploadSizeExceededException 来捕获上传文件过大的异常。你可以在全局异常处理器中处理它：

java

import org.springframework.web.bind.annotation.ExceptionHandler; import org.springframework.web.bind.annotation.RestControllerAdvice; import org.springframework.web.multipart.MaxUploadSizeExceededException; @RestControllerAdvice public class FileUploadExceptionHandler { @ExceptionHandler(MaxUploadSizeExceededException.class) public String handleMaxSizeException(MaxUploadSizeExceededException exc) { return "File size exceeds the maximum limit!"; } }

通过这种方式，你可以更友好地处理文件上传大小超过限制的情况，给用户返回一个合适的错误提示。

总结来说，关键是设置合适的文件上传大小限制，并在上传文件时捕获相关的异常。

如果出现这个异常无法通过自定义异常处理器捕获，如何解决？

org.apache.tomcat.util.http.fileupload.impl.SizeLimitExceededException 是 Tomcat 在处理上传文件时抛出的异常，通常与文件上传的大小超过了 Tomcat 配置的最大大小有关。你提到的异常提示表明请求的文件大小 1961417234 字节（大约 1.8GB）超过了配置的最大大小 1048576000 字节（大约 1GB）。这个异常确实可能不会直接通过 Spring 的 @ExceptionHandler 捕获，因为它是在 Tomcat 请求解析阶段就被触发的，而不是在 Spring 的控制器方法中。

为了解决这个问题，确保能够捕获这个异常并做出适当响应，可以采取以下几个步骤：

1. 配置 Tomcat 的上传大小限制

首先，确保在 Spring Boot 的配置文件中正确设置了文件上传的大小限制：

application.properties：

properties

spring.servlet.multipart.max-file-size=2GB spring.servlet.multipart.max-request-size=2GB

application.yml：

yaml

spring: servlet: multipart: max-file-size: 2GB max-request-size: 2GB

这将确保 Spring Boot 能够正确处理文件上传请求并设置合理的文件大小限制。

2. 捕获 `SizeLimitExceededException` 异常

由于 SizeLimitExceededException 异常是在 Tomcat 的内部上传解析时抛出的，因此你需要通过 Tomcat 的 ErrorPageFilter 或 自定义过滤器 来捕获这些异常。

2.1 使用 `ErrorPageFilter` 捕获异常

Spring Boot 提供了 ErrorPageFilter 类，你可以通过它来捕获这个类型的错误，并转到自定义的错误页面。

首先，在你的应用中创建一个 ErrorPage 配置：

java

import org.springframework.boot.web.servlet.ErrorPage; import org.springframework.boot.web.servlet.FilterRegistrationBean; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.http.HttpStatus; import org.springframework.boot.web.servlet.filter.ErrorPageFilter; @Configuration public class ErrorPageConfig { @Bean public FilterRegistrationBean<ErrorPageFilter> errorPageFilter() { FilterRegistrationBean<ErrorPageFilter> registrationBean = new FilterRegistrationBean<>(); registrationBean.setFilter(new ErrorPageFilter()); registrationBean.addUrlPatterns("/*"); registrationBean.setOrder(1); return registrationBean; } @Bean public ErrorPage errorPage() { return new ErrorPage(HttpStatus.BAD_REQUEST, "/upload-error"); } }

2.2 自定义错误页面

创建一个错误页面，例如 /upload-error，可以通过一个控制器返回自定义错误信息：

java

import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.RequestMapping; @Controller public class ErrorController { @RequestMapping("/upload-error") public String handleUploadError() { return "upload-error"; // 你的错误页面 } }

这样，在文件上传超出限制时，Tomcat 会将请求重定向到 /upload-error，并在这个页面中展示错误信息。

3. 自定义过滤器

如果你需要更细致的控制，或者想捕获上传时异常并在应用级别处理，可以使用自定义过滤器：

java

import org.apache.catalina.connector.Request; import org.apache.catalina.connector.Response; import org.springframework.web.filter.OncePerRequestFilter; import javax.servlet.Filter; import javax.servlet.FilterChain; import javax.servlet.FilterConfig; import javax.servlet.ServletException; import java.io.IOException; public class FileUploadSizeFilter extends OncePerRequestFilter { @Override protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain) throws ServletException, IOException { try { filterChain.doFilter(request, response); } catch (SizeLimitExceededException ex) { // 自定义处理异常 response.sendError(HttpServletResponse.SC_BAD_REQUEST, "File size exceeds the maximum allowed limit."); } } }

然后注册该过滤器：

java

import org.springframework.boot.web.servlet.FilterRegistrationBean; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; @Configuration public class FilterConfig { @Bean public FilterRegistrationBean<FileUploadSizeFilter> fileUploadSizeFilter() { FilterRegistrationBean<FileUploadSizeFilter> registrationBean = new FilterRegistrationBean<>(); registrationBean.setFilter(new FileUploadSizeFilter()); registrationBean.addUrlPatterns("/upload"); return registrationBean; } }

4. 设置全局异常处理

如果你使用的是 @ExceptionHandler 来处理异常，但 SizeLimitExceededException 没有被捕获，可以通过全局异常处理器捕获相关异常并做适当响应：

java

import org.apache.tomcat.util.http.fileupload.impl.SizeLimitExceededException; import org.springframework.http.HttpStatus; import org.springframework.web.bind.annotation.ControllerAdvice; import org.springframework.web.bind.annotation.ExceptionHandler; import org.springframework.web.bind.annotation.ResponseStatus; @ControllerAdvice public class GlobalExceptionHandler { @ExceptionHandler(SizeLimitExceededException.class) @ResponseStatus(HttpStatus.BAD_REQUEST) public String handleFileSizeLimitExceeded(SizeLimitExceededException ex) { return "File size exceeds the maximum allowed limit."; } }