spring boot报FileSizeLimitExceededException异常的解决方法

本文介绍了SpringBoot中文件上传的默认限制及如何通过配置application.yaml或application.properties来调整每个文件和单次请求的最大文件大小。

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

开发spring boot程序时,遇到了如下错误:
The field file exceeds its maximum permitted size of 1048576 bytes.

原因:
Spring Boot工程嵌入的tomcat限制了请求的文件大小,官方文档中这样描述:

Spring Boot embraces the Servlet 3 javax.servlet.http.Part API to support uploading files. By default Spring Boot configures Spring MVC with a maximum file of 1Mb per file and a maximum of 10Mb of file data in a single request.

翻译一下:每个文件的最大为1Mb,单次请求的文件的总数不能大于10Mb。

解决方法:
spring boot 2.0 之后,在配置文件application.yaml或 application.properties中增加如下配置:

spring.servlet.multipart.max-file-size=100MB
spring.servlet.multipart.max-request-size=1000MB

如果想不让文件大小受限,将spring.servlet.multipart.max-file-size这个参数设置成-1。

Spring Boot中,默认情况下,如果你试图上传一个1GB大小的文件而没有做任何配置或优化,大概率是不会成功的。这是因为Spring默认对请求体(包括文件上传)设置了**最大尺寸限制**。 --- ### **关于文件上传大小限制** 1. **是否有大小限制?在哪里设置?** - Spring Boot 默认有一个内置的最大文件上传限制:`MAX_FILE_SIZE = 1MB` 和 `MAX_REQUEST_SIZE = 10MB`。 - 这些限制通常由嵌入式 Tomcat 或其他 Servlet 容器控制,并可通过 application.properties 文件中的以下属性进行自定义: ```properties spring.servlet.multipart.max-file-size=20MB # 单个文件最大大小 spring.servlet.multipart.max-request-size=20MB # 整个请求内容最大大小 ``` 2. **如果未配置会发生什么?** - 当你尝试上传超过默认限制的文件时,Spring Boot 应用程序会抛出异常,通常是类似下面这样的错误信息: ``` org.springframework.web.multipart.MaxUploadSizeExceededException: Maximum upload size exceeded; nested exception is java.lang.IllegalStateException:org.apache.tomcat.util.http.fileupload.impl.FileSizeLimitExceededException: The field file exceeds its maximum permitted size of 1048576 bytes. ``` 3. **如果我限制为20MB但上传了一个1GB文件怎么办?** - 如果你在项目中明确设定了 `max-file-size=20MB` 和 `max-request-size=20MB`,并且用户仍然尝试上传一个大于此限制的文件,应用程序会在读取请求的过程中检测到超出了设定的阈值,并立即终止请求处理流程。 - 此时你可以捕获 `MaxUploadSizeExceededException` 异常并通过全局异常处理器返回友好的提示消息给前端用户。例如: ```java @ControllerAdvice public class FileUploadException Advice { @ExceptionHandler(MaxUploadSizeExceededException.class) public ResponseEntity<String> handleMaxSizeException(MaxUploadSizeExceededException exc) { return ResponseEntity.status(HttpStatus.EXPECTATION_FAILED).body("File too large!"); } } ``` --- ### **解决大文件上传问题** 针对需要上传非常大的文件(如 1GB),你需要采取以下措施之一: #### 方法一:调整服务器端配置支持更大文件 - 修改application.properties文件以允许更大的文件和请求: ```properties spring.servlet.multipart.enabled=true spring.servlet.multipart.max-file-size=1GB spring.servlet.multipart.max-request-size=1GB ``` - 需要注意的是,这可能会导致内存占用过高以及性能下降等问题。因此建议仅适用于小规模的应用环境。 #### 方法二:分片上传 + 后台合并 - 将大文件拆分成多个较小的部分(比如每个部分不超过20MB),然后逐块发送至服务器存储临时路径下。 - 最后再通知后台按照顺序拼接所有碎片形成完整的大文件。 - 示例伪代码如下: 前端: ```javascript function splitAndSend(file) { const chunkSize = 20 * 1024 * 1024; // 每段20MB let start = 0; while (start < file.size){ var end = Math.min(start + chunkSize, file.size); sendChunk(file.slice(start,end)); start += chunkSize; } } async function sendChunk(chunk){ ... } ``` 后端: ```java private void mergeChunks(List<FilePart> chunks) throws IOException{ try(FileOutputStream fos=new FileOutputStream(outputFilePath)){ for(var part : chunks){ Files.copy(part.getFile().toPath(),fos); } } } ``` #### 方法三:流式传输 - 使用 HTTP 的流模式(Streaming)而非一次性加载整个文件进内存的方式完成上传过程。 - 流式上传可以让服务端边接收数据边写硬盘,极大减少 RAM 开销的同时也能更好地适应超大型资源的需求。 --- 总结来说,未经任何改动的话无法顺利完成如此庞大的文件上传任务;但如果做好相应准备工作还是完全可行哒!
评论 2
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

打赏作者

大数据技术部落

觉得有收获就支持一下吧~

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

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

打赏作者

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

抵扣说明:

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

余额充值