You need to enable JavaScript to run this app. Laravel+jQuery实现多文件附件上传时仅接收单个文件的问题
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.16 05:24:02