Laravel+jQuery实现多文件附件上传时仅接收单个文件的问题
Laravel 多文件上传仅接收单个文件的故障排查与实现方案
已搭建的基础逻辑
- 前端侧:配置支持多选的文件输入框
<input type="file" name="adjunto" id="adjunto" multiple>,通过jQuery获取选中文件实例,将文件对象存入FormData实例后,通过AJAX发送至Laravel后端控制器 - 后端侧:实现三个核心流程:将上传文件移动至
public/subidas目录、将前端提交的表单字段连同附件文件名一起写入incidencias数据表、触发邮件发送流程通知处理人员
异常现象
- 无论调整前端文件获取逻辑、修改FormData的字段名结构,后端通过
$request->file('file')获取到的上传文件数组始终仅包含1个文件对象,即便前端选中2张及以上图片文件,后端var_dump输出的上传文件数组长度始终为1 - 已尝试通过
formData.append('file[]', 取单个文件的方式)构造请求,依然无法解决多文件接收不全的问题
核心故障原因
- FormData构造时未逐次循环追加文件,直接将整体FileList对象作为单个值传入,导致后端仅识别为单文件对象
- 循环追加文件时未给字段名加
[]后缀,多次调用append方法传入同名字段时,新值会覆盖旧值,最终仅最后一次追加的文件会被提交到后端 - AJAX配置错误:未关闭
processData、contentType的默认设置,导致FormData被强制序列化,文件列表无法正常传输 - 后端接收时使用的字段名与前端FormData追加的字段名不匹配,导致无法正确捕获数组格式的文件字段
完整可运行实现方案
前端修正
- 调整FormData构造逻辑,必须逐文件循环追加,且统一使用带
[]后缀的字段名,AJAX需关闭默认序列化配置:
const formData = new FormData(); // 获取DOM上选中的全部文件列表 const selectFiles = $('#adjunto')[0].files; // 循环遍历每一个选中文件逐次追加 for (let index = 0; index < selectFiles.length; index++) { // 字段名保持统一加[],让后端识别为数组 formData.append('adjunto[]', selectFiles[index]); } // 追加其他普通表单字段 formData.append('detalle_incidencia', $('#detalle').val()); // 配置AJAX请求 $.ajax({ url: '/submit-incidencia', method: 'POST', data: formData, // 这两个参数必须设为false,否则无法正常传输文件 contentType: false, processData: false, success: (res) => { // 处理提交结果 } })
后端修正
- 接收请求时使用对应的带
[]后缀的字段名,Laravel会自动将该字段解析为上传文件数组,逐文件处理存储与入库:
public function submitIncidencia(Request $request) { // 校验规则:adjunto为数组,每个元素为合规上传文件 $validated = $request->validate([ 'adjunto' => 'required|array', 'adjunto.*' => 'file|max:10240', // 单文件最大10MB 'detalle_incidencia' => 'required|string' ]); $storedFileNames = []; // 遍历处理每一个上传文件 if ($request->hasFile('adjunto')) { foreach ($request->file('adjunto') as $file) { // 生成带唯一前缀的文件名,避免重名覆盖 $safeFileName = uniqid() . '_' . $file->getClientOriginalName(); // 移动文件到目标目录 $file->move(public_path('subidas'), $safeFileName); // 收集文件名用于后续入库 $storedFileNames[] = $safeFileName; } } // 写入incidencias表,文件名以JSON格式存储 Incidencia::create([ 'detalle_incidencia' => $validated['detalle_incidencia'], 'adjuntos' => json_encode($storedFileNames) ]); // 后续邮件发送流程中,将存储的文件路径传入邮件附件构造方法即可 }
注意:如果前端循环追加文件时不带[]后缀,FormData会自动覆盖同名字段的旧值,最终仅最后一次追加的文件会被发送到后端,这是绝大多数多文件上传仅能接收到1个文件的核心原因。
内容的提问来源于stack exchange,提问作者daviserraalonso
相关产品推荐
相关产品推荐

