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

最新推荐文章于 2025-05-12 13:59:10 发布
最新推荐文章于 2025-05-12 13:59:10 发布
阅读量1.5k 收藏 8
点赞数 11
CC 4.0 BY-SA版权
分类专栏： # 报错记录 文章标签： java spring boot 前端
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/Keep__Me/article/details/135838352
文章讲述了在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下的文件大小配置，修改为大于你文件大小的值即可。

在这里插入图片描述

spring mvc上传文件超过设定大小异常处理客户端无响应：请求的连接被重置
Boone的博客
07-31 1万+
controller类： @RequestMapping(path = "/file", method = RequestMethod.POST) public UploadMsg uploadFile(@RequestParam("uploadFile") MultipartFile file, String userCode) throws Exception { ...
Swagger-ui在文件上传时报错net::ERR_CONNECTION_RESET
yingziisme的博客
07-28 5155
Swagger-ui在文件上传时报错net::ERR_CONNECTION_RESET 项目版本 spring-boot 2.1.6.RELEASE swagger 2.7.0 在使用swagger做接口测试的时候遇到了一个诡异的问题，在文件超过限制大小的时候，没有按照全局异常拦截返回相应的错误码，而是直接抛出了一个net::ERR_CONNECTION_RESET的报错，页面没有任何返回显示 测...
org.springframework.web.multipart.MaxUploadSizeExceededException: Maximum upload size exceeded
weixin_73060959的博客
09-09 2021
这个异常通常发生在Spring MVC或Spring Boot应用中，当上传的文件大小超过了服务器配置的最大允许大小时。这个限制可以在多个级别上设置，包括Servlet容器（如Tomcat）、Spring Boot的配置文件（如或），或者在Spring MVC的配置类中。
Java开发：springboot出现MaxUploadSizeExceededException 异常
新人小白，请多指教
05-12 448
注意上面最重要的是要配置内嵌的 tomcat 的最大吞吐量即 max-swallow-size，可以设置 -1 不限制，也可以设置一下比较大的数字这里微酷设置 100M。当上传文件超 tomcat 的大小限制后会先于 Controller 触发异常，所以这时我们的异常处理类无法捕获 Controller 层的异常。问题来了，当文件超过 1M 和超过 10M 时异常是有区别的，这也是本文所说的重点。解决方案，来自stackoverflow的解决方案，大家了解下。文件超 10M 的异常信息。
org.springframework.web.multipart.MaxUploadSizeExceededException: Maximum upload size exceeded；
xinbuliaoqing9
09-28 1547
接口上传文件，文件超过默认大小报错 信息：org.springframework.web.multipart.MaxUploadSizeExceededException: Maximum upload size exceeded; 解决方法： 在 springboot的配置文件 yml 中 添加下方配置信息 spring servlet: multipart: max-file-size: 10MB #单个最大文件大小 max-request-size: 10MB #总
解决org.springframework.web.multipart.MaxUploadSizeExceededException: Maximum upload size exceeded
泯灭于众生，高歌于孤夜！
08-31 2104
spring.http.server.maxFileSize和spring.http.server.maxRequestSize的值,效果是一样的。然后在application.properties文件中配置。原因：上传文件的请求有个默认配置最大值是2M 超出了最大值。方法二，重写config配置类。
org.springframework.web.multipart.MaxUploadSizeExceededException: Maximum upload size exceeded; nes
热门推荐
luhongzheng的博客
03-12 1万+
使用springboot上传文件,当文件超过2M报出异常 异常显示org.springframework.web.multipart.MaxUploadSizeExceededException: Maximum upload size exceeded; nested exception is java.lang.IllegalStateException: org.apache.tomcat...
org.springframework.web.multipart.MaxUploadSizeExceededException: Maximum upload size exceeded； nest
Kaaaakaki的博客
03-09 334
上传的文件大小超过了限制 1048576 bytes. = 1M 修改application.properties文件 # 最大上传单个文件大小：默认1M spring.servlet.multipart.max-file-size=1024MB # 最大置总上传的数据大小 ：默认10M spring.servlet.multipart.max-request-size=1024MB ...
org.springframework.web.multipart.MaxUploadSizeExceededException
ChinaMuZhe的博客
03-25 6777
公司指派给我一个任务，做一个项目的二期开发。从其他项目组接手过来后，测试文件上传中 报错： org.springframework.web.multipart.MaxUploadSizeExceededException: Maximum upload size of 1048576 bytes exceeded; nested exception is org.apache.commons...
org.springframework.web.multipart.MaxUploadSizeExceededException: Maximum upload size exceeded； nes
FangWenJuno的博客
06-23 345
Spring boot项目文件上传大小异常 spring boot项目默认文件上传大小为:1048576 bytes. 不同的版本对应的配置文件配置方式不同 Spring Boot 1.3.x and earlier multipart.maxFileSize multipart.maxRequestSize Spring Boot 1.4.x and 1.5.x spring.http.multipart.maxFileSize spring.http.multipart.maxRequestSize
SpringBoot异常：MaxUploadSizeExceededException: Maximum upload size exceeded
m0_48580015的博客
05-09 639
【代码】SpringBoot异常：MaxUploadSizeExceededException: Maximum upload size exceeded。
org.springframework.web.multipart.MaxUploadSizeExceededException: Maximum up解决方案
qq_44730827的博客
04-15 3629
application.properties spring.servlet.multipart.enabled=true spring.servlet.multipart.max-file-size=100MB spring.servlet.multipart.max-request-size=100MB spring.servlet.multipart.file-size-threshold=0 spring.servlet.multipart.location=/usr/local/project/fi
上传文件大小限制异常springframework.web.multipart.MaxUploadSizeExceededException
weixin_44094017的博客
09-07 443
错误信息： error,msg={} org.springframework.web.multipart.MaxUploadSizeExceededException: Maximum upload size exceeded; nested exception is java.lang.IllegalStateException: org.apache.tomcat.util.http.fileupload.FileUploadBase$FileSizeLimitExceededException: Th
文件上传遇到org.springframework.web.multipart.MultipartException：Maximum upload size exceeded；解决方法
m0_60938243的博客
07-28 3037
在使用springboot进行文件上传时，因为springboot对上传的文件大小有默认，如果需要上传文件的大小超过默认值，则需要重新配置上传限制。
SpringBoot文件上传报错 errorHandler:org.springframework.web.multipart.MaxUploadSizeExceededException:
MR.骑士道
07-26 2643
一、错误原因
Caused by: java.lang.IllegalStateException: org.apache.tomcat.util.http.fileupload.FileUploadBase$Fi...
牧牛人Alec
08-15 2919
文件大小限制异常： 上传的文件大于了1048576 bytes. 单位换算得出：1024*1024=1048576 bytes=1 M org.springframework.web.multipart.MaxUploadSizeExceededException: Maximum upload size exceeded; nested exception is java.lang...
org.springframework.web.multipart.MaxUploadSizeExceededException Maximum upload size exceeded
m0_74823507的博客
12-10 1098
这个异常通常发生在Spring MVC或Spring Boot应用中，当上传的文件大小超过了服务器配置的最大允许大小时。这个限制可以在多个级别上设置，包括Servlet容器（如Tomcat）、Spring Boot的配置文件（如或），或者在Spring MVC的配置类中。
解决org.springframework.web.multipart.MaxUploadSizeExceededException报错问题
松门一枝花
05-28 2982
在springboot中接收到上传的文件时候，出现了这种错误 org.springframework.web.multipart.MaxUploadSizeExceededException: Maximum upload size exceeded; nested exception is java.lang.IllegalStateException: org.apache.tomcat.util.http.fileupload.FileUploadBase$FileSizeLimitExcee...
Resolved [org.springframework.web.multipart.MaxUploadSizeExceededException: Maximum upload size exceeded]
最新发布
06-11
### 如何处理 `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、付费专栏及课程。

余额充值