Spring Boot多文件上传出现首个文件重复上传问题求助

前端排查点 #

• 检查FormData构建代码：确认是否存在重复追加首个文件的逻辑，比如先单独执行formData.append("files", files[0])，随后又遍历整个文件列表再次追加，导致首个文件被添加两次。
• 验证请求 payload：打开浏览器开发者工具的Network面板，找到上传请求，查看FormData中的文件条目，确认前端实际发送的文件数量和内容是否包含重复的首个文件。
• 检查事件绑定：确认文件选择的change事件是否被重复绑定，导致一次文件选择触发两次追加操作。

后端排查点 #

• 检查Controller接收逻辑：确认是否存在重复接收文件参数的情况，比如同时使用@RequestParam("files") MultipartFile[] files和其他注解（如@RequestPart）接收同一参数，或者方法参数中存在重复的文件参数定义。
• 打印接收文件信息：在Service层入口处打印接收到的文件数组长度、每个文件的原始文件名和大小，判断重复文件是在前端请求时就存在，还是后端处理过程中产生的。
• 检查Service处理逻辑：确认是否在循环处理文件前，额外对首个文件执行了一次保存操作，比如先调用fileService.save(files[0])，再遍历数组批量保存，导致重复入库。
• 排查数据库操作：检查DAO层的保存方法是否被重复调用，比如事务切面、AOP代理是否导致保存逻辑执行了两次。
• 检查全局组件：排查项目中的拦截器、过滤器是否对Multipart请求做了额外处理，导致文件被重复解析或提交。

调试方向 #

• 前端：在append文件的代码行添加console.log，记录每次追加的文件名，实时观察是否有重复追加的情况。
• 后端：在Controller接收参数后、Service处理前、DAO保存前这三个关键节点分别打印文件列表的详细信息，定位重复出现的具体环节。
• 临时注释部分逻辑：逐步注释后端的保存逻辑，只保留打印操作，或者注释前端的部分追加代码，缩小问题范围。

内容的提问来源于stack exchange，提问作者Ajay Kumar