千家信息网

SpringBoot上传文件大小受限问题怎么解决

发表于:2026-10-31 作者:千家信息网编辑
千家信息网最后更新 2026年10月31日,这篇文章主要介绍"SpringBoot上传文件大小受限问题怎么解决",在日常操作中,相信很多人在SpringBoot上传文件大小受限问题怎么解决问题上存在疑惑,小编查阅了各式资料,整理出简单好用的操作
千家信息网最后更新 2026年10月31日SpringBoot上传文件大小受限问题怎么解决

这篇文章主要介绍"SpringBoot上传文件大小受限问题怎么解决",在日常操作中,相信很多人在SpringBoot上传文件大小受限问题怎么解决问题上存在疑惑,小编查阅了各式资料,整理出简单好用的操作方法,希望对大家解答"SpringBoot上传文件大小受限问题怎么解决"的疑惑有所帮助!接下来,请跟着小编一起来学习吧!

1、控制台异常

org.springframework.web.multipart.MaxUploadSizeExceededException: Maximum upload size exceeded; nested exception is java.lang.IllegalStateException: org.apache.tomcat.util.http.fileupload.FileUploadBase$FileSizeLimitExceededException: The field file exceeds its maximum permitted size of 1048576 bytes.        at org.springframework.web.multipart.support.StandardMultipartHttpServletRequest.handleParseFailure(StandardMultipartHttpServletRequest.java:121)        at org.springframework.web.multipart.support.StandardMultipartHttpServletRequest.parseRequest(StandardMultipartHttpServletRequest.java:114)

从上述异常可以看出,是因为上传的file文件超过了spring默认配置的最大值1048576 bytes,上传文件我们通常情况下是使用MultipartFile接口类接收前端上传的文件,可见对于MultipartFile文件的默认限制也是1048576 bytes,即1M。

但是很多情况下我们用手机直接拍摄的证件照或者是文档问阿金基本都是在2M以上,很显然这不能满足我们的日常需求,所以我们就要修改默认配置参数大小。

2、上传文件默认参数

SpringBoot不同的版本,对应的设置参数不同:

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

Spring Boot 2.x

  • spring.servlet.multipart.maxFileSize

  • spring.servlet.multipart.maxRequestSize

3、解决方法

3.1、方法1(在配置文件.yml或者.properties中直接修改参数)

例如我使用的是SpringBoot 2.1.3的版本,然后直接再配置文件中设置参数大小:

#做限制的参数配置spring:  servlet:    multipart:      enabled: true #默认支持文件上传      max-file-size: 20MB # 最大支持文件大小      max-request-size: 30MB # 最大支持请求大小#不做限制的参数配置spring:  servlet:    multipart:      enabled: true #默认支持文件上传      max-file-size: -1 #不做限制      max-request-size: -1 #不做限制

设置完重启项目即可成功上传文件。

3.2、方法2(自定义config配置类)

将参数配置在远程配置文件中心,如果是配置项目中的配置文件中,那就跟方法1一样了,就没必要再单独写配置类了,将参数配置在远程配置中心,就是为了可以根据临时需求动态修改参数,而不用重启项目。

常见的远程配置文件中心服务有Nacos、Apollo(阿波罗)、SpringCloud等等,我使用的是Nacos配置中心服务:

自定义MultipartFileConfig配置类:

import org.springframework.beans.factory.annotation.Value;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;/** * @author: 一宿君 * @date: 2022-03-23 19:18:51 * @description:  */@Configurationpublic class MultipartFileConfig {    @Value("${config.multifile.maxFileSize}")    private Long maxFileSize;    @Value("${config.multifile.maxRequestSize}")    private Long maxRequestSize;    @Bean    public MultipartConfigElement multipartConfigElement() {        MultipartConfigFactory factory = new MultipartConfigFactory();        /**         * 单个数据大小,         * DataSize.ofMegabytes(maxFileSize)默认是配置字节,将字节转化为MB         */        factory.setMaxFileSize(DataSize.ofMegabytes(maxFileSize));        // 总上传数据大小        factory.setMaxRequestSize(DataSize.ofMegabytes(maxRequestSize));        return factory.createMultipartConfig();    }}

这样就可以随时控制上传文件的大小了!

到此,关于"SpringBoot上传文件大小受限问题怎么解决"的学习就结束了,希望能够解决大家的疑惑。理论与实践的搭配能更好的帮助大家学习,快去试试吧!若想继续学习更多相关知识,请继续关注网站,小编会继续努力为大家带来更多实用的文章!

文件 配置 大小 参数 问题 方法 限制 学习 支持 最大 项目 不同 字节 情况 数据 更多 版本 需求 帮助 控制 数据库的安全要保护哪些东西 数据库安全各自的含义是什么 生产安全数据库录入 数据库的安全性及管理 数据库安全策略包含哪些 海淀数据库安全审计系统 建立农村房屋安全信息数据库 易用的数据库客户端支持安全管理 连接数据库失败ssl安全错误 数据库的锁怎样保障安全 互联网科技巨头监管 关于新基建和互联网科技 礼当家互联网科技 善班互联网科技有限公司 火传媒上海互联网科技 中国互联网金融科技基金 成都仁贤领冠互联网科技有限公司 互联网巨头投资的硬核科技 隆华科技工业互联网 互联网金融科技公司干啥的 彤创互联网科技有限公司 苏州五指互联网络科技有限 恒生互联网科技指数跳水 互联网科技研发水平 科技大学互联网 陕西云淼互联网科技公司 互联网科技平台产品运营 科技和互联网行业的特点 互联网科技大佬云集 广东猫王互联网科技有限公司电话 苏州找大状互联网科技有限公司 重生之互联网科技帝国 厦门中拓互联网络科技有限公司 互联网科技媒体 互联网高科技企业 深圳市运趣互联网科技有限公司 广州互联网高科技取餐柜 南京一网一红互联网科技有限公司 上海同邻互联网科技有限公司规模 恒生科技互联网指数十大成分股
0