Springboot接口如何接收多个文件以及如何将其保存到服务器

更新时间：2026年05月27日 11:03:16 作者：缴鸿剑Jackson

本文给大家介绍了Springboot接口如何接收多个文件以及如何将其保存到服务器,本文结合实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧

一.接收多个文件（即接收文件List）

1.核心思路：使用post请求、List<MultipartFile>，就可以接收文件list

2.代码编写

@Api(tags = "测试接口")
@RestController
@RequestMapping("/test")
public class TestController {
    @PostMapping("/hello")
    public String hello(@RequestParam("files") List<MultipartFile> files) {
        if(files == null || files.isEmpty()){
            return "请选择至少一个文件";
        }
        for(MultipartFile file : files){
            if(!file.isEmpty()){
                //获取文件名
                String originalFilename = file.getOriginalFilename();
                //获取文件大小（单位是B，即Byte字节）
                long fileSize = file.getSize();
                //获取文件类型
                String fileType = file.getContentType();
                //日志输出到控制台
                System.out.println("成功接收文件："+ originalFilename +"，文件大小为："+fileSize+"，文件类型为："+fileType);
            }
        }
        return "成功接收"+files.size()+"个文件！";
    }
}

3.使用apifox发送请求该接口，传入多个文件

如下图，我们要注意几点：

要发送post请求
参数要选择Body->form-data

①思考：为什么发送文件，请求类型一定要选择Post？传参一定要选择Body->form-data?

由于文件只能放到Body中，而Get请求不支持Body传参，所以只能使用Post请求
由于文件上传必须使用 multipart/form-data 编码格式，这是 HTTP/1.1 协议（RFC 7578）规定的标准方式。所以传文件时，参数要选择Body->form-data

②报错原因分析：Maximum upload size exceeded（超过最大上传限制）

上传文件list的场景中，Spring Boot默认值为：

单个文件的大小上限：1MB
单次请求的文件总大小上限：10MB

这是我们上述传的四个文件，可见此时该次请求的总文件大小也就3~4MB，没问题符合要求，但是“双录测试视频.mp4”这个文件，超出了单个文件大小上限（1MB）。因此我们要设置一下这个上限，调大点。

4.配置：调整上传文件的大小限制

如下图，我们此时提高了文件大小的上限：

单个文件大小的上限提升至20MB
单次请求的文件总大小上限提升至50MB

5.再次使用apifox发送请求，传入多个文件

可以去控制台，查看一下上传的日志：

注意：file.getSize()这个方法，获取的文件大小的单位是Byte（即字节）。

二.将接收的文件，保存到本地/服务器

1.添加如下图的两段代码

2.使用apifox，发送请求，测试一下

3.查看本机的指定目录，是否多出了这四个文件

以上就是本篇文章的全部内容，喜欢的话可以留个免费的关注呦~~~

到此这篇关于Springboot接口如何接收多个文件以及如何将其保存到服务器的文章就介绍到这了,更多相关springboot接收多个文件内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

java中list使用时需避免的场景总结
众所周知,Java为开发者提供了多种集合类的实现,其中几乎所有业务代码都需要用到List,但List的错误使用也会导致诸多问题,所以本文我们就来看一看几个错误使用List的场景吧
2023-10-10
Java应用多机器部署解决大量定时任务问题
这篇文章主要介绍了Java应用多机器部署解决大量定时任务问题,两台服务器同时部署了同一套代码，代码中写有spring自带的定时任务，但是每次执行定时任务时只需要一台机器去执行,需要的朋友可以参考下
2019-07-07
详解Java信号量Semaphore的原理及使用
Semaphore来自于JDK1.5的JUC包，直译过来就是信号量，被作为一种多线程并发控制工具来使用。本文将详解其原理与使用方法，感兴趣的可以学习一下
2022-05-05
Java异常的几个谜题_动力节点Java学院整理
本文给大家收藏整理java异常的几个谜题，非常不错，具有参考借鉴价值，需要的朋友参考下吧
2017-06-06
Java内存模型JMM详解
这篇文章主要介绍了Java内存模型JMM详解，涉及volatile和监视器锁，final字段，内存屏障等相关内容，具有一定参考价值，需要的朋友可以了解下。
2017-11-11
Java中队列Queue和Deque的区别与代码实例
学过数据结构的,一定对队列不陌生,java也实现了队列,下面这篇文章主要给大家介绍了关于Java中队列Queue和Deque区别的相关资料,需要的朋友可以参考下
2021-08-08
java基础学习笔记之泛型
所谓泛型，就是变量类型的参数化。泛型是JDK1.5中一个最重要的特征。通过引入泛型，我们将获得编译时类型的安全和运行时更小的抛出ClassCastException的可能。在JDK1.5中，你可以声明一个集合将接收/返回的对象的类型。
2016-02-02
SpringBoot3.x打包Docker容器的实现
这篇文章主要介绍了SpringBoot3.x打包Docker容器的实现,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-11-11
Java如何实现判断并输出文件大小
这篇文章主要介绍了Java如何实现判断并输出文件大小问题，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2023-04-04
Springboot集成阿里云OSS上传文件系统教程
这篇文章主要介绍了Springboot集成阿里云OSS上传文件系统教程,通过详细的图文展示,代码步骤的展示和文件配置信息,希望对你有所帮助
2021-06-06