Layui upload需手动实现批量校验与汇总提示：在done/error中缓存结果至数组，allDone中统一处理；失败信息需通过data-index精准回填对应文件行；后端批量返回时须按文件名或顺序映射；注意iOS换行、allDone兼容性及DOM顺序一致性。
点击提交按钮后才触发所有文件校验并汇总提示
layui upload 模块本身不提供「批量校验 + 汇总提示」能力，它的 done、error 都是单文件粒度回调。要实现“全部上传完再统一提示成功/失败数量”，必须绕过默认流程，手动收集结果。
关键不是等 upload 自动汇总，而是自己维护一个状态数组，在每个 done 或 error 回调里 push 结果，最后在 allDone 里统一处理。
-
allDone是唯一能拿到总文件数、成功数、失败数的钩子，但它不传具体每条结果——你得自己存 - 别在
done里直接弹layer.msg()，否则会弹多次；改用数组缓存{name, status, msg} - 如果后端返回结构不一致（比如成功时返回
{code:0}，失败时返回{code:1, msg:"xxx"}），要在done和error里做归一化处理 - 示例片段：
let uploadResults = []; upload.render({ elem: '#uploadBtn', url: '/api/upload', multiple: true, auto: true, done: function(res, index, upload) { uploadResults.push({ name: upload.filename, status: 'success', msg: res.msg || '上传成功' }); }, error: function(index, upload) { uploadResults.push({ name: upload.filename, status: 'error', msg: '上传失败' }); }, allDone: function(obj) { const successCount = uploadResults.filter(r => r.status === 'success').length; const failCount = obj.aborted; // 注意：obj.aborted 是 layui 统计的失败数，但可能和你数组里的不一致，以数组为准 if (failCount > 0) { const failMsgs = uploadResults .filter(r => r.status === 'error') .map(r => `【${r.name}】${r.msg}`) .join('\n'); layer.msg(failMsgs, { time: 5000, icon: 5 }); } else { layer.msg(`全部 ${obj.total} 个文件上传成功`, { icon: 6 }); } uploadResults = []; // 清空，防重复累积 } });上传失败时如何把错误信息精准回填到对应文件行
默认情况下，Layui 的
layui-upload-list只显示文件名和状态图标，不展示具体错误原因。用户无法知道是哪个文件因何失败——尤其当多个文件并发上传时。解决办法是在
done或error回调中，找到该文件对应的 DOM 节点（通常是<tr>或<div class="layui-upload-file">），插入错误提示文本或图标。- Layui 不暴露文件与 DOM 的映射关系，但你在
choose回调里可通过obj.pushFile()拿到文件队列，每个文件有唯一index；上传时这个index会透传给done/error的第三个参数upload对象 - 提前在
choose时为每个文件生成带data-index的 DOM 插入到列表中，后续就能用$('[data-index="' + upload.index + '"]')精准定位 - 不要直接修改
layui-upload-list内部结构，避免和 layui 自身渲染逻辑冲突；建议用append()加一个<span class="upload-error"></span>容器，再填内容 - 样式上加
.upload-error { color: #ff5722; font-size: 12px; display: block; margin-top: 4px; }，避免撑开布局
后端返回批量结果时前端如何解析并匹配到各文件
有些后端接口不走单文件单请求，而是接收 FormData 后统一处理，返回一个数组形式的结果，例如：
{"files": [{"name":"a.jpg","code":0},{"name":"b.pdf","code":1,"msg":"类型不支持"}]}。这时前端无法靠done/error区分，必须自己解析。这意味着你要禁用
auto: true，改用auto: false+ 手动fetch，并在响应解析后，按文件名或顺序一一映射回 UI。- 在
choose回调中用Array.from(obj.files)缓存原始文件列表，确保顺序和后端返回数组一致 - 上传完成后，遍历后端返回的
res.files，用file.name去比对原始文件列表的file.name，找到对应 DOM 节点更新状态 - 注意文件名可能被后端重命名（如加时间戳），此时需约定后端返回原始
originalName字段，否则匹配会失效 - 如果后端不返回原始名，只能靠索引匹配，但必须确保上传时 FormData.append 的顺序与后端解析顺序严格一致——这在 Node.js / PHP / Java 中行为未必统一，慎用
汇总提示容易被忽略的兼容性细节
看似简单的汇总提示，在真实项目里常因环境差异出问题：iOS Safari 下
layer.msg()多行文本换行失效、某些版本 layui 的allDone不触发、甚至 Windows Edge 旧内核对FormData的append行为不一致。-
layer.msg()的换行在移动端需显式写\n，且 CSS 要设white-space: pre-line，否则全挤成一行 - layui 2.8.18 之前版本的
allDone在auto: false场景下不会触发，必须升级或改用upload.start()后手动监听load事件模拟 - 如果用了
sortable.js管理上传列表顺序，allDone触发时 DOM 顺序可能已变，但你缓存的文件数组还是原始选择顺序——二者不一致会导致提示错位 - 最稳妥的做法：所有提示逻辑都基于你维护的数组，而不是依赖 layui 的内部统计字段（如
obj.successful），因为这些字段在异常中断、网络抖动时可能不准
- Layui 不暴露文件与 DOM 的映射关系，但你在
