springboot之如何快速实现多文件上传？若不会，我便手把手教你【详细】

一起养成写作习惯！这是我参与「掘金日新计划 · 4 月更文挑战」的第17天，点击查看活动详情。

一、前言🔥

👨‍🎓作者：bug菌

✏️博客：CSDN、掘金等

💌公众号：猿圈奇妙屋

🚫特别声明：原创不易，转载请附上原文出处链接和本文声明，谢谢配合。

🙏版权声明：文章里可能部分文字或者图片来源于互联网或者百度百科，如有侵权请联系bug菌处理。

哈喽，小伙伴们，我是bug菌呀👀，不知不觉就一年又4月，正是踏青郊游的好时节。可上海疫情，除了在家远程办公就是看点技术顺便卷点文章。这不是4月又出了更文活动，逼自己一把，坚持每天做点内容输出，养成写作习惯，将来你会回来感谢曾经的自己坚持了一把才有此刻的辉煌成就。

小伙伴们在批阅文章的过程中如果觉得文章对您有一丝丝帮助，还请别吝啬您手里的赞呀，大胆的把文章点亮👍吧，您的点赞三连(收藏⭐️+关注👨‍🎓+留言📃)就是对bug菌我创作道路上最好的鼓励与支持😘。时光不弃🏃🏻‍♀️，掘金不停💕，加油☘️

二、环境说明🔥

**环境：**jdk1.8 + springboot 2.3.1RELEASE

三、需求分析🔥

突然加了这么个需求，要求对用户材料文件需要手动上传并指定文件路径保存。好家伙，一听，觉得没啥问题，又觉得有点欠妥，于是我便问了这么一句，需要支持文件批量嘛？你不问我还没觉得，那就加上吧！可支持用户批量上传。

这不是自己给自己加戏么?这开过光的嘴！说啥来啥，那能咋办，干就完了！

四、实现思路🔥

其实对于文件上传，还是老样子，通过formData表单提交的方式进行文件附件上传，而不是现在所谓的json接收格式数据，比如@RequestBody注解；那为什么不能用它来接收？因为@RequestBody默认接收的enctype(MIME编码)是application/json，因此发送POST请求时需要设置请求报文头信息，否则SpringMVC在解析集合请求参数时是不会自动转换成JSON数据再解析成相应的集合。

那对于multipart/form-data 提交方式，那我们就可以通过使用@RequestParam(springmvc中接收普通参数的注解)，将请求参数绑定到控制器的方法参数上，或者你也省略映射不需要绑定(这就要求命名必须一致)，那就靠spring对于formdata带文件和数据字段一起上传的情况做自动映射。如果需要对参数进行重命名，那么你就可以使用@RequestParam 映射前端传过来的字段名，而接收的时候自己自定义就行，比如如下这种方式，前端传给你的参数字段叫id，而你接收则是用dfId。

@RequestParam("id") String dfId
复制代码

而对于多文件的话，我们就可以定义一个 MultipartFile [] 数组接收即可。比如如下演示：

@RequestParam("files") MultipartFile[] files
复制代码

这样的话，结合一下不就支持多文件上传协同其他字段一并提交处理了。

五、实现方案🔥

通过上方我们对此的分析可得，我们可以有两种方式可以进行实现，虽然大同小异，但是论标准，我就给大家讲一种最合理的实现方式，接下来我以实际例子作为演示。

比如，批量文件+数据字段的情况，论这种需求接口应该怎么定义呢？很好办呀？看我给大家露一手。仅供参考：

具体实现代码如下：

    @PostMapping(value = "/upload-files")
    @ApiOperation(value = "文件上传(支持批量)", notes = "文件上传(支持批量)")
    public ResultResponse<Boolean> uploadFiles(@RequestParam("files") MultipartFile[] files,
                                               @RequestParam("type")  Integer type,
                                               @RequestParam("id") String dfId) throws IOException {
        return declarationFormService.uploadFiles(files, type, dfId);
    }
复制代码

然后我们来通过postman来测试下该接口，看看是否能拿到该参数信息，包括文件。

接下来我们在接口上打个断点，查看一下这些参数能否都被正常接收？

如下是实际断点截图：

接收到的参数信息与我postman所添加的参数内容完全一致，接收正常，能看到文件也是以数组的格式展示(MultipartFile [ 2 ])，这就意味着你待会儿如果要进行文件保存，那你就可以通过使用files进行循环一波即可。

比如我实际保存写法，仅供参考：

... ...

ok，以上这样就好啦，如果还想学习更多，你可以看看我的往期热文推荐哦，每天积累一个奇淫小知识，日积月累下去，你一定能成为令人敬仰的大佬的。好啦，咱们下期见~

六、往期推荐🔥

七、文末🔥

如果还想要学习更多，小伙伴们可关注bug菌专门为大家创建的专栏《SpringBoot零基础入门》，从无到有，从零到一！希望能帮到大家。

我是bug菌，一名想走👣出大山改变命运的程序猿。接下来的路还很长，都等待着我们去突破、去挑战。来吧，小伙伴们，我们一起加油！未来皆可期，fighting！

最后送大家两句我很喜欢的话，与诸君共勉！

**************************************************

☘️做你想做的人，没有时间限制，只要愿意，什么时候都可以start，

🍀你能从现在开始改变，也可以一成不变，这件事，没有规矩可言，你可以活出最精彩的自己。