layui upload多文件上传 layui如何实现一次性上传多个文件-Layui教程-PHP中文网

layui.upload默认不支持多文件一次性上传，需设auto:false并手动用FormData+fetch发送；否则每个文件单独请求，后端须适配单文件接收或数组字段如files[]。

layui upload 一次选中多个文件却只传一个

默认情况下 layui.upload 的 multiple 属性只是控制「能否多选」，不等于「自动批量上传」——你勾了 multiple: true，但没配 auto: false + 手动调用 upload.render() 的上传逻辑，它仍会逐个触发单次请求。

常见错误现象：choose 回调里拿到多个 files，但 done 只执行一次，且 res 里只有第一个文件的结果。

必须设 auto: false，否则 layui 会为每个文件单独发一次请求（不是你想要的“一次性”）
choose 回调中缓存 obj 实例和 files 列表，别直接在回调里调 obj.upload()
用 obj.upload() 手动上传时，传入的是单个 File 对象；要一次性发多个，得自己构造 FormData 并用原生 fetch 或 $.ajax

用原生 fetch + FormData 实现真正的一次性多文件上传

layui 的 upload 模块不支持把多个 File 打包进一个请求体，默认行为就是单文件单请求。想“一次性”，就得绕过它的 upload 方法，自己组请求。

使用场景：后端接口接收的是 multipart/form-data，字段名如 files[] 或 fileList，要求所有文件在同一个 HTTP 请求里。

在 choose 回调中收集所有 files，存在闭包变量或组件实例属性里
构造 FormData 时，对每个 File 调用 formData.append('files[]', file)（注意字段名需与后端约定一致）
不要传 contentType 给 fetch —— 浏览器会自动设置带 boundary 的 multipart/form-data
如果后端需要额外参数（如 token、dir），也用 formData.append() 加进去

示例片段：

choose: function(obj){
  var files = obj.files;
  // 缓存起来，等用户点「上传」按钮再发
  uploadFiles = Array.from(files);
},
// 假设有个按钮绑定 click
document.getElementById('uploadBtn').onclick = function(){
  var formData = new FormData();
  uploadFiles.forEach(function(file){
    formData.append('files[]', file); // 注意中括号，适配 PHP 等后端
  });
  formData.append('token', 'xxx');
  fetch('/api/upload', {method: 'POST', body: formData})
    .then(r => r.json())
    .then(console.log);
};

layui upload 的 `url` 配置和后端接收的兼容性坑

如果你坚持用 obj.upload() 发送（即走 layui 默认流程），那每个文件都会以独立请求发出，此时 url 必须能处理单文件上传逻辑；若强行让后端在一个接口里收多个文件，就会出现「400 Bad Request」或字段解析失败。

深蓝色网站后台管理系统layui框架模板-AdminPro

一款深蓝色网站后台管理系统layui框架模板

下载

典型错误信息：Required request part 'file' is not present（Spring Boot）、Undefined index: file（PHP）——因为后端只写了接收单个 file 字段的代码。

用 layui 默认上传方式时，后端接口必须设计为「单文件接收」，哪怕前端选了十个，也是十个请求
想共用一个后端接口处理多文件，就必须自己发 FormData 请求，并确保后端明确支持数组式字段（如 files[] 或 files 数组）
Node.js（Koa/Express）需用 multer 的 array('files[]', 10)；PHP 要用 $_FILES['files'] 数组结构读取
注意 Nginx 默认限制单次请求体大小（client_max_body_size），传十个大文件容易 413