Spring Boot文件上传大小限制问题及解决方案详解
个人名片
🎓作者简介：java领域优质创作者
🌐个人主页：码农阿豪
📞工作室：新空间代码工作室（提供各种软件服务)
💌个人邮箱：[2435024119@qq.com]
📱个人微信：15279484656
🌐个人导航网站：www.forff.top
💡座右铭：总有人要赢。为什么不能是我呢？
- 专栏导航：
码农阿豪系列专栏导航
面试专栏：收集了java相关高频面试题，面试实战总结🍻🎉🖥️
Spring5系列专栏：整理了Spring5重要知识点与实战演练，有案例可直接使用🚀🔧💻
Redis专栏：Redis从零到一学习分享，经验总结，案例实战💐📝💡
全栈系列专栏：海纳百川有容乃大，可能你想要的东西里面都有🤸🌱🚀
Spring Boot文件上传大小限制问题及解决方案详解
1. 引言
在开发Web应用程序时，文件上传是一个常见的需求。然而，Spring Boot默认对上传文件的大小有限制（通常为1MB），当用户上传超过该限制的文件时，系统会抛出MaxUploadSizeExceededException异常，导致上传失败。本文将详细介绍如何分析和解决Spring Boot文件上传大小限制问题，并提供多种配置方式，确保文件上传功能正常运行。
2. 问题分析
2.1 错误日志解读
在用户上传文件时，如果文件大小超过默认限制（1MB），Spring Boot会抛出如下异常：
org.apache.tomcat.util.http.fileupload.impl.FileSizeLimitExceededException:
The field files exceeds its maximum permitted size of 1048576 bytes.
这表明上传的文件超过了1048576 bytes（即1MB）的限制。
2.2 异常堆栈分析
从堆栈信息可以看出，该异常是由Tomcat的FileUpload组件触发的，最终被Spring的DispatcherServlet捕获并包装成MaxUploadSizeExceededException。
3. 解决方案
3.1 方法1：通过application.properties或application.yml配置
Spring Boot允许我们通过配置文件调整上传文件的大小限制。
3.1.1 使用application.properties
# 单个文件最大大小（这里设置为10MB）
spring.servlet.multipart.max-file-size=10MB
# 整个请求的最大大小（这里设置为20MB）
spring.servlet.multipart.max-request-size=20MB
3.1.2 使用application.yml
spring:
servlet:
multipart:
max-file-size: 10MB
max-request-size: 20MB
3.2 方法2：通过Java配置类（推荐）
如果希望更灵活地控制文件上传配置，可以使用MultipartConfigFactory来动态设置。
3.2.1 创建MultipartConfig配置类
import org.springframework.boot.web.servlet.MultipartConfigFactory;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.util.unit.DataSize;
import javax.servlet.MultipartConfigElement;
@Configuration
public class MultipartConfig {
@Bean
public MultipartConfigElement multipartConfigElement() {
MultipartConfigFactory factory = new MultipartConfigFactory();
// 单个文件大小限制（10MB）
factory.setMaxFileSize(DataSize.ofMegabytes(10));
// 总请求大小限制（20MB）
factory.setMaxRequestSize(DataSize.ofMegabytes(20));
return factory.createMultipartConfig();
}
}
3.3 方法3：旧版本Spring Boot（1.x）的配置方式
在Spring Boot 1.x中，配置方式略有不同：
# 旧版本属性名
multipart.maxFileSize=10MB
multipart.maxRequestSize=20MB
4. 进阶优化：文件上传校验
4.1 前端校验
在HTML表单中，可以添加accept和max-size限制：
<input type="file" name="files" accept=".jpg,.png,.pdf" max-size="10485760" multiple />
4.2 后端校验
在Controller层增加文件大小校验逻辑：
@PostMapping("/upload")
@ApiOperation(value = "渠道账号-文件上传", notes = "渠道账号-文件上传")
public Res<List<String>> uploadChannelFile(
@RequestParam("files") MultipartFile[] files,
@RequestParam("channelId") String channelId,
@RequestParam("agentId") String agentId,
@RequestParam("opUser") String opUser) {
try {
// 检查每个文件大小（10MB限制）
for (MultipartFile file : files) {
if (file.getSize() > 10 * 1024 * 1024) {
return new Res<>(SupResultCode.CODE_900500, "文件大小不能超过10MB", null);
}
}
List<String> docLinks = opmChannelAccountService.uploadChannelFiles(files, channelId, agentId, opUser);
return new Res<>(ResultCode.CODE_000000, ResultCode.MSG_000000, docLinks);
} catch (Exception e) {
log.error("文件上传失败", e);
return new Res<>(SupResultCode.CODE_900500, "文件上传失败: " + e.getMessage(), null);
}
}
4.3 全局异常处理
可以自定义异常处理器，提供更友好的错误提示：
@ControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(MaxUploadSizeExceededException.class)
public ResponseEntity<String> handleMaxUploadSizeExceeded(MaxUploadSizeExceededException ex) {
return ResponseEntity
.status(HttpStatus.PAYLOAD_TOO_LARGE)
.body("文件大小超过限制，请上传小于10MB的文件");
}
}
5. 生产环境建议
5.1 使用分片上传
对于大文件（如视频、大型文档），建议采用分片上传（Chunked Upload）：
- 前端使用
File.slice()切分文件 - 后端使用
MultipartFile接收分片并合并
5.2 异步处理
如果文件处理较耗时，可以使用@Async异步处理：
@Async
public void processLargeFile(MultipartFile file) {
// 处理大文件
}
5.3 存储优化
- 使用OSS（如阿里云OSS、AWS S3）存储文件
- 避免直接存储在服务器本地
6. 总结
本文详细介绍了Spring Boot文件上传大小限制问题的解决方案，包括：
- 配置文件调整（
application.properties/application.yml） - Java配置类方式（推荐）
- 前端+后端双重校验
- 全局异常处理优化
- 生产环境建议（分片上传、异步处理）
通过合理配置和优化，可以有效解决文件上传限制问题，提升用户体验和系统稳定性。
7. 参考资料
希望本文能帮助你解决Spring Boot文件上传大小限制问题！ 🚀
浙公网安备 33010602011771号