springboot附件上传超限org.apache.tomcat.util.http.fileupload.FileUploadBase$FileSizeLimitExceededException

最新推荐文章于 2025-05-27 11:17:23 发布
置顶 最新推荐文章于 2025-05-27 11:17:23 发布
阅读量958 收藏
点赞数
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/qq_39341192/article/details/89334034
本文介绍了解决SpringBoot项目中文件上传超出默认大小限制的问题。通过自定义MultipartConfigElement，设置单个文件及总上传数据的最大大小，有效避免了上传大文件时出现的错误。

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

1.项目使用的是Spring Boot ，上传附件报超出自带tomacat限制大小（默认1M）

org.apache.tomcat.util.http.fileupload.FileUploadBase$FileSizeLimitExceededException: The field file exceeds its maximum permitted size of xxx bytes.

2.解决方案

  /**
     * 文件上传配置
     * 
     * @return
     */
    @Bean
    public MultipartConfigElement multipartConfigElement() {
        MultipartConfigFactory factory = new MultipartConfigFactory();
        //  单个数据大小
        factory.setMaxFileSize("10240KB"); // KB,MB
        /// 总上传数据大小
        factory.setMaxRequestSize("102400KB");
        return factory.createMultipartConfig();
    }

springboot文件上传超限org.apache.tomcat.util.http.fileupload.FileUploadBase$FileSizeLimitExceededException
10-22 8281
一、错误原因 springboot项目在上传较大文件时报错： Maximum upload size exceeded;org.apache.tomcat.util.http.fileupload.FileUploadBase$FileSizeLimitExceededException: The field file exceeds its maximum permitted size of...
org.apache.tomcat.util.http.fileupload.FileUploadBase$FileSizeLimitExceededException: The field xxx ...
weixin_30851409的博客
02-25 404
springboot 通过MultipartFile接受前端传过来的文件时是有文件大小限制的（springboot内置tomact的的文件传输默认为1MB），我们可以通过配置改变它的大小限制 首先在启动类中加入: @configuration 再在启动类中加上代码 @Bean public MultipartConfigElement multipartConfi...
异:org.apache.tomcat.util.http.fileupload.FileUploadException
三木的博客
05-27 378
异常描述:the request was rejected because no multipart boundary was found。比如:如果你后端使用的是@RequestBody接受数据,那么,你的前端就必须传json格式的数据,而不是form-data表单格式的数据。解决方案:查看自己的前端请求数据类型和后端接口接受类型是否一致。错误分析:multipart表单解析错误。
org.apache.tomcat.util.http.fileupload.FileUploadBase$FileSizeLimitExceededException: The field file
Knight
07-12 1612
org.apache.tomcat.util.http.fileupload.FileUploadBase$FileSizeLimitExceededException: The field file exceeds its maximum permitted size of 1048576 bytes.
org.apache.tomcat.util.http.fileupload.FileUploadBase$SizeLimitExceededException: the request was re
qq_38446141的博客
10-17 1795
org.apache.tomcat.util.http.fileupload.FileUploadBase$SizeLimitExceededException: the request was rejected because its size tomcat传输文件过大报错解决方法 tomcat传输文件过大报错 解决方法 扩大tomcat传输容量 在yml配置文件中添加 spring.serv...
解决org.apache.tomcat.util.http.fileupload.FileUploadBase$SizeLimitExceededException: 的问题
爱吃鸡腿的明仔
12-02 4009
一。问题描述 SpringBoot项目上传较大文件时出现以下报错： org.apache.tomcat.util.http.fileupload.FileUploadBase$SizeLimitExceededException: the request was rejected because its size (159612974) exceeds the configured maximum (10485760) 二。解决办法 在application.yml文件中添加以下配置： spring:
基于apache commons.fileupload的文件上传组件
07-17
Apache Commons FileUpload是一个Java库，专门用于处理HTTP协议中的文件上传功能。这个组件使得在Web应用中接收用户通过表单提交的多个文件变得容易。基于此库，我们可以创建一个简单的文件上传组件，以处理文件上传...
apache-tomcat-util.jar
03-08
jar包，亲测可用
【问题解决】Springboot项目java.util.concurrent.ExecutionException: org.apache.catalina.LifecycleException
一见你就笑
11-27 2778
2019-11-26 18:02:27.486 ERROR 109370 --- [Tomcat-startStop-1] org.apache.catalina.core.ContainerBase : A child container failed during start java.util.concurrent.ExecutionException: org.apache.cat...
org.apache.tomcat.util.http.fileupload.FileUploadBase$SizeLimitExceedException
u014240299的专栏
11-07 2388
spring项目报上传文件过大的异常 项目是由springboot编辑环境开发的，报错之前其中配置application.yml里相关配置： spring: thymeleaf: mode: HTML encoding: utf-8 cache: false servlet: multipart: max-file-size: 1...
springboot上传文件过大org.apache.tomcat.util.http.fileupload.FileUploadBase$FileSizeLimitExceededException
吾行远方
08-29 1万+
1.使用Spring Boot 上传文件报超出自带tomacat限制大小（默认1M）异常： org.apache.tomcat.util.http.fileupload.FileUploadBase$FileSizeLimitExceededException: The field head_name exceeds its maximum permitted size of 1048576 by...
org.apache.tomcat.util.http.fileupload.FileUploadBase$FileSizeLimitExceededException:
weixin_34364135的博客
11-02 324
经过几个小时的排查：问题出现在网关需要加上：spring.http.multipart.enabled: truespring.http.multipart.maxFileSize: 10Mbspring.http.multipart.maxRequestSize: 10Mb 转载于:https://blog.51cto.com/17099933344/19782...
【springboot】org.apache.tomcat.util.http.fileupload.FileUploadBase$FileSizeLimitExceededException
One_castle的博客
10-19 849
【springboot】org.apache.tomcat.util.http.fileupload.FileUploadBase$FileSizeLimitExceededException 问题描述 使用springboot实现上传文件功能的时候，由于上传的文件大小较大（Tomcat默认允许上传的文件最大为1MB），超过1MB的文件进行上传程序就会报错： org.apache.tomcat.util.http.fileupload.FileUploadBase$FileSizeLimitExceede
org.apache.tomcat.util.http.fileupload.FileUploadBase$FileSizeLimitExceededException
Smile__1的博客
08-10 991
报错 org.apache.tomcat.util.http.fileupload.FileUploadBase$FileSizeLimitExceededException: The field multipartFile exceeds its maximum permitted size of 1048576 bytes. 解决办法 在yml文件配置 spring: servlet: ...
Tomcat上传文件限制大小：org.apache.tomcat.util.http.fileupload.FileUploadBase$FileSizeLimitExceededException
林大侠
11-25 3399
  SpringBoot项目，操作阿里云的视频点播测试上传视频，出现如下异常，主要原因是tomcat上传文件大小有限制的，默认1M大小。   解决方案：设置上传文件大小限制，在application.properties配置上传文件大小即可！ #最大上传单个文件大小：默认1M,现在是1G spring.servlet.multipart.max-file-size=1024MB # 最大置总上传的...
spring boot上传附件报错：org.apache.tomcat.util.http.fileupload.FileUploadBase$SizeLimitExceededException
热门推荐
fxj0720的博客
05-09 3万+
org.springframework.web.multipart.MultipartException: Could not parse multipart servlet request; nested exception is java.lang.IllegalStateException: org.apache.tomcat.util.http.fileupload.FileUploadB...
MultiPart上传问题：org.apache.tomcat.util.http.fileupload.FileUploadBase$FileSizeLimitExceededException
JerryTan89的博客
04-24 441
multipart报错
org.apache.tomcat.util.http.fileupload.impl.FileCountLimitExceededException:attachment
最新发布
07-19
<think>我们正在解决用户上传文件时遇到的`FileCountLimitExceededException`异常，这个异常是由于上传的文件数量超过了Spring Boot（内嵌Tomcat）的默认限制。 根据引用[2]的信息，Spring Boot自带的Tomcat对上传文件有默认限制：每个文件最大1MB，单次请求总大小不超过10MB，并且对文件数量也有限制（默认可能是1个文件？但实际异常是文件数量超出，说明用户上传的文件数量超过了默认值）。 在Spring Boot中，文件上传数量限制由`spring.servlet.multipart.max-file-count`属性控制。但根据用户之前的上下文，用户可能已经尝试配置了该属性但未生效（“the elements spring.servlet.multipart.max-file-count were left u”），所以我们需要确保配置正确且生效。 解决方案步骤： 1. 确认Spring Boot版本：因为不同版本配置方式略有不同（特别是1.x和2.x以上）。 2. 在配置文件中正确设置相关属性，包括最大文件数量、单个文件大小和请求总大小。 3. 如果使用内嵌Tomcat，还需要注意Tomcat自身的限制（在Spring Boot中通过`server.tomcat`前缀配置）。 4. 自定义错误处理（可选）。 根据引用[2]的提示，Spring Boot 2.5.6版本中，我们需要设置以下属性（对于更高版本同样适用，如3.x）： 在`application.properties`中： ```properties # 设置单个文件最大大小 spring.servlet.multipart.max-file-size=10MB # 设置整个请求的最大大小 spring.servlet.multipart.max-request-size=100MB # 设置最大文件数量（关键） spring.servlet.multipart.max-file-count=50 ``` 或者，在`application.yml`中： ```yaml spring: servlet: multipart: max-file-size: 10MB max-request-size: 100MB max-file-count: 50 ``` 注意：在Spring Boot 1.x中，配置前缀是`spring.http.multipart`，但1.x版本不支持`max-file-count`属性。因此，如果用户使用的是1.x版本，需要升级到2.x或更高版本。 另外，内嵌Tomcat本身也有对POST请求大小的限制，可以通过以下属性设置： ```properties server.tomcat.max-http-form-post-size=100MB ``` 如果用户已经设置了`spring.servlet.multipart.max-file-count`但未生效，可能是因为： - 配置位置不正确（应放在`application.properties`或`application.yml`中，且被正确加载） - 版本不兼容（低于2.1.0的Spring Boot不支持该属性） - 存在多个配置文件导致覆盖 如果用户使用的是Spring Boot 3.x，配置属性名称相同。 如果用户不想升级Spring Boot版本（比如还在用1.x），则需要通过编程方式配置。但1.x版本不支持文件数量限制，所以可能需要升级。 下面给出一个完整的配置示例和自定义配置类的方案（当属性配置不生效时，可以通过编程方式设置）。 步骤： 1. 确认Spring Boot版本（至少2.1.0以上）。 2. 在配置文件中设置上述属性。 3. 如果仍然不生效，考虑自定义一个`MultipartConfigElement`或`CommonsMultipartResolver`（根据使用的Servlet容器）。 自定义配置示例（适用于Spring Boot 2.x和3.x）： ```java 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 jakarta.servlet.MultipartConfigElement; @Configuration public class MultipartConfiguration { @Bean public MultipartConfigElement multipartConfigElement() { MultipartConfigFactory factory = new MultipartConfigFactory(); // 设置单个文件最大大小 factory.setMaxFileSize(DataSize.ofMegabytes(10)); // 设置总请求大小 factory.setMaxRequestSize(DataSize.ofMegabytes(100)); // 注意：MultipartConfigFactory没有直接设置文件数量的方法，所以文件数量限制需要通过其他方式（如拦截器）或确保使用spring.servlet.multipart.max-file-count属性 // 实际上，在Spring Boot中，文件数量限制是通过Tomcat的配置实现的，所以如果使用内嵌Tomcat，设置spring.servlet.multipart.max-file-count即可。 return factory.createMultipartConfig(); } } ``` 但是，`MultipartConfigFactory`并不支持设置最大文件数量。因此，设置文件数量限制只能通过属性配置（`spring.servlet.multipart.max-file-count`）或者通过自定义Tomcat的配置（不常用）。 因此，我们回到属性配置，并确保它生效。 如果用户遇到的是`FileCountLimitExceededException`，那么一定是文件数量超出了限制。所以，我们只需要正确设置`max-file-count`属性即可。 另外，用户可能同时遇到文件大小和文件数量的限制，所以建议同时设置三个属性（max-file-size, max-request-size, max-file-count）。 最后，如果用户使用的是Spring Boot 1.x，则无法通过属性设置文件数量限制，需要升级到2.x或更高版本。 总结： 1. 升级到Spring Boot 2.1.0以上（如果当前版本过低）。 2. 在配置文件中设置： ```properties spring.servlet.multipart.max-file-size=10MB spring.servlet.multipart.max-request-size=100MB spring.servlet.multipart.max-file-count=50 ``` 3. 如果使用内嵌Tomcat，还可以设置`server.tomcat.max-http-form-post-size`（但通常设置`max-request-size`已经足够）。 4. 如果配置后仍然不生效，检查是否有其他配置文件覆盖，或者尝试在启动类或配置类中通过系统属性设置： ```java System.setProperty("spring.servlet.multipart.max-file-count", "50"); ``` 5. 如果用户坚持使用Spring Boot 1.x，则需要通过编程方式自定义上传解析器，但1.x版本本身不支持文件数量限制，所以可能需要修改代码在Controller中手动检查文件数量，或者升级。 由于用户之前提到“spring.servlet.multipart.max-file-count were left u”，可能是配置未被识别，所以请用户检查配置文件的加载位置和优先级。 相关问题： 1. 如何查看Spring Boot加载的配置属性？ 2. Spring Boot多文件上传的完整示例？ 3. 如何自定义Spring Boot文件上传的错误信息？ 4. Spring Boot 1.x中如何限制上传文件数量？ 5. 内嵌Tomcat与独立Tomcat在文件上传配置上的区别？</think>要解决`FileCountLimitExceededException`（文件数量超出限制）问题，需针对Spring Boot内嵌Tomcat的文件上传限制进行配置优化。以下是具体解决方案： ### 原因分析 1. **默认限制触发** Tomcat默认限制单次请求的文件数量（通常为1-10个），超出会抛出： ```java org.apache.tomcat.util.http.fileupload.impl.FileCountLimitExceededException ``` 2. **配置未生效** `spring.servlet.multipart.max-file-count`属性未正确绑定或版本不兼容[^2] --- ### 解决方案 #### 步骤1：基础配置（推荐） 在`application.properties`中添加： ```properties # 最大文件数量（关键） spring.servlet.multipart.max-file-count=20 # 单个文件最大大小 spring.servlet.multipart.max-file-size=10MB # 整个请求最大大小 spring.servlet.multipart.max-request-size=100MB # Tomcat特定限制（需同时设置） server.tomcat.max-http-form-post-size=100MB ``` 或在`application.yml`中： ```yaml spring: servlet: multipart: max-file-count: 20 max-file-size: 10MB max-request-size: 100MB server: tomcat: max-http-form-post-size: 100MB ``` #### 步骤2：编程式配置（兼容旧版本） ```java import org.springframework.boot.web.servlet.MultipartConfigFactory; import org.springframework.context.annotation.Bean; import javax.servlet.MultipartConfigElement; @Configuration public class FileUploadConfig { @Bean public MultipartConfigElement multipartConfigElement() { MultipartConfigFactory factory = new MultipartConfigFactory(); // 设置文件数量限制 factory.setMaxFileCount(20); factory.setMaxRequestSize(DataSize.ofMegabytes(100)); return factory.createMultipartConfig(); } } ``` #### 步骤3：Tomcat直接配置（极端情况） 在`application.properties`中添加： ```properties # 直接调整Tomcat参数 server.tomcat.max-http-form-post-size=100MB # 旧版本兼容（Spring Boot 1.x） spring.http.multipart.max-file-count=20 ``` --- ### 验证方案 1. **测试Controller**： ```java @PostMapping("/upload") public String uploadFiles(@RequestParam("files") MultipartFile[] files) { return "已接收文件数: " + files.length; } ``` 2. **使用curl测试**： ```bash curl -F "files=@file1.txt" -F "files=@file2.txt" http://localhost:8080/upload ``` --- ### 关键注意事项 1. **版本兼容性**： - Spring Boot 2.1+：使用`spring.servlet.multipart.*` - Spring Boot 1.x：使用`spring.http.multipart.*`[^2] 2. **配置优先级**： ```mermaid graph LR A[编程式配置] -->|最高优先级| B[生效] C[application.properties] -->|次高| B D[默认值] -->|最低| B ``` 3. **完整限制链**： - 文件数量：`max-file-count` - 单文件大小：`max-file-size` - 总请求大小：`max-request-size` + `max-http-form-post-size` > **最佳实践**：生产环境建议设置`max-file-count=50`，`max-request-size`至少为`max-file-size * max-file-count * 1.5`[^2] --- ### 常见问题排查 | 现象 | 解决方案 | |------|----------| | 配置未生效 | 检查是否有多个`application-*.yml`冲突 | | 旧项目迁移 | 删除所有`spring.http.multipart.*`旧配置 | | 超限无提示 | 添加`@ControllerAdvice`全局异常处理 | | 上传大文件失败 | 同时增加`server.tomcat.max-swallow-size` |
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

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

余额充值