Java中SpringBoot上传文件时报错:org.springframework.web.multipart.MaxUploadSizeExceededException

文章讲述了在SpringMVC中遇到的MaxUploadSizeExceededException,原因是文件上传大小超过了默认的2MB限制。解决方法是找到并调整servlet.multipart.max-file-size配置以适应更大的文件尺寸。

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

完整报错信息:

org.springframework.web.multipart.MaxUploadSizeExceededException: Maximum upload size exceeded; nested exception is java.lang.IllegalStateException:
org.apache.tomcat.util.http.fileupload.impl.SizeLimitExceededException: the request was rejected because its size (803477000) exceeds the configured maximum (20971520)

原因:文件上传大小超出配置文件中的限制

解决方案:修改配置文件

找到配置中的spring:servlet:multipart下的文件大小配置,修改为大于你文件大小的值即可。

在这里插入图片描述

### 如何处理 `org.springframework.web.multipart.MaxUploadSizeExceededException` 异常 在Spring Boot中,当上传文件大小超过服务器配置的最大限制,会抛出 `org.springframework.web.multipart.MaxUploadSizeExceededException` 异常。以下是解决该问题的详细方法: #### 1. 配置文件调整 可以在 `application.properties` 或 `application.yml` 文件中设置文件上传的最大限制。例如: ```properties # application.properties spring.servlet.multipart.max-file-size=10MB spring.servlet.multipart.max-request-size=10MB ``` 或者在 `application.yml` 中配置为: ```yaml # application.yml spring: servlet: multipart: max-file-size: 10MB max-request-size: 10MB ``` 上述配置分别设置了单个文件和整个请求的最大大小[^1]。 #### 2. 自定义异常处理 为了更好地处理此异常,可以创建一个全局异常处理器。例如: ```java import org.springframework.web.bind.annotation.ExceptionHandler; import org.springframework.web.bind.annotation.RestControllerAdvice; import org.springframework.web.multipart.MaxUploadSizeExceededException; @RestControllerAdvice public class FileUploadExceptionAdvice { @ExceptionHandler(MaxUploadSizeExceededException.class) public ResponseEntity<String> handleMaxSizeException(MaxUploadSizeExceededException exc) { return ResponseEntity.status(HttpStatus.EXPECTATION_FAILED) .body("File too large! Maximum allowed size is " + exc.getMaxUploadSize() + " bytes."); } } ``` 通过这种方式,可以向客户端返回更友好的错误信息[^3]。 #### 3. Servlet容器配置 如果使用的是嵌入式Tomcat,可以通过修改Servlet容器的配置来调整文件上传限制。例如,在Spring Boot的主类或配置类中添加以下代码: ```java import org.springframework.boot.web.embedded.tomcat.TomcatConnectorCustomizer; import org.springframework.boot.web.embedded.tomcat.TomcatServletWebServerFactory; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; @Configuration public class TomcatConfig { @Bean public TomcatServletWebServerFactory tomcatEmbedded() { TomcatServletWebServerFactory tomcatFactory = new TomcatServletWebServerFactory(); tomcatFactory.addConnectorCustomizers((TomcatConnectorCustomizer) connector -> { connector.setMaxPostSize(10 * 1024 * 1024); // 设置为10MB }); return tomcatFactory; } } ``` 这段代码直接调整了Tomcat的POST请求大小限制[^4]。 #### 4. 请求头与参数体检查 确保客户端发送的请求头正确。对于文件上传,建议将 `Content-Type` 设置为 `multipart/form-data`,而不是 `application/json`。如果使用工具(如Postman)测试接口,需确保在请求体中选择了 `form-data` 而非其他类型[^5]。 --- ###
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

丿BAIKAL巛

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值