### 如何使用SpringBoot List集合接收前端Form表单多个文件上传 在SpringBoot中，通过`List<MultipartFile>`可以实现接收前端传递的多张图片或其他类型的文件。以下是具体方法： #### 1. 后端接口设计 定义一个控制器方法用于接收文件列表。需要引入`MultipartFile`作为参数类型，并将其封装到`List`中。 ```java import org.springframework.web.bind.annotation.PostMapping; import org.springframework.web.bind.annotation.RequestParam; import org.springframework.web.multipart.MultipartFile; import java.util.List; @RestController @RequestMapping("/upload") public class FileUploadController { @PostMapping("/files") public String handleFileUpload(@RequestParam("files") List<MultipartFile> files) { if (files != null && !files.isEmpty()) { for (MultipartFile file : files) { if (!file.isEmpty()) { try { // 文件保存逻辑 byte[] bytes = file.getBytes(); // 可以在此处将字节流写入磁盘或数据库 System.out.println("FileName: " + file.getOriginalFilename()); } catch (Exception e) { return "Error uploading file."; } } } } return "Files uploaded successfully!"; } } ``` 此代码片段展示了如何通过`@RequestParam`注解获取名为`files`的文件列表[^1]。 --- #### 2. 配置文件解析器 为了支持`multipart/form-data`请求格式，需确保项目已配置好`spring.servlet.multipart.*`相关属性。通常情况下，默认配置即可满足需求，但如果涉及大文件或多文件上传，则可能需要调整以下参数： ```properties spring.servlet.multipart.enabled=true spring.servlet.multipart.max-file-size=10MB spring.servlet.multipart.max-request-size=50MB ``` 这些配置项分别表示启用文件上传功能、单个文件的最大大小以及整个HTTP请求允许的最大尺寸[^4]。 --- #### 3. 前端发送请求 假设使用Postman测试工具提交数据，按照如下步骤操作： - 请求方式：POST； - URL地址：`http://localhost:8080/upload/files`； - Body部分选择`form-data`模式； - 添加键名统一命名为`files`（与后端保持一致），并依次附加每一张待上传的照片文件[^4]。 如果采用JavaScript发起Ajax调用，可借助FormData对象构建请求体： ```javascript let formData = new FormData(); // 将选中的所有文件加入formData Array.from(document.getElementById('photoInput').files).forEach(file => { formData.append('files', file); }); fetch('/upload/files', { method: 'POST', body: formData, }) .then(response => response.text()) .then(result => console.log(result)) .catch(error => console.error('Error:', error)); ``` 此处的关键在于每次向`formData`追加新条目时都指定了相同的key——即`files`[^2]。 --- #### 4. 注意事项 当尝试混合其他字段一同递交时可能会遇到一些兼容性问题。例如某些版本框架默认不允许同时携带常规字符串型参数和二进制资料块一起传输。此时要么单独分开两次调用完成各自的任务；要么自定义拦截器或者过滤链修改原始HttpServletRequest实例从而绕过校验机制[^3]。 另外值得注意的一点是关于重复命名冲突的情况。假如既存在独立变量又嵌套于复杂结构内部共享相同的名字则可能导致覆盖现象发生。因此建议尽量避免这种情况出现以免引起不必要的麻烦[^1]。 ---