choose回调中必须立即清理上一次文件队列:先保存当前pushFile()结果,再遍历删除旧键,最后赋值交接;同时清空uploadInst.files、DOM预览列表并调用reload()三步缺一不可。

choose 回调里必须立刻清理上一次的文件队列
用户反复点击“选择文件”按钮时,choose 会不断触发,而 obj.pushFile() 每次返回的是新增文件组成的键值对象(key 如 "1612418956647-0"),不是覆盖而是追加。不清理就会越积越多,导致后续 uploadInst.upload() 或自动上传时重复发请求。
关键不是删 uploadInst.files,而是拿到当前队列快照后手动清空旧键:
- 在
choose开头就执行const currentFiles = obj.pushFile() - 用闭包变量(如
let UPLOAD_FILES = {})保存上一轮队列 - 遍历
UPLOAD_FILES,对每个key执行delete UPLOAD_FILES[key] - 再把
currentFiles赋给UPLOAD_FILES,完成交接
别直接 UPLOAD_FILES = currentFiles —— 这样旧引用还在内存里,且下次 pushFile() 返回的新对象会被丢弃,状态不同步。
uploadInst.files = [] 不足以清空 UI 和内部状态
只写 uploadInst.files = [] 会让 JS 队列为空,但 DOM 预览列表还在,reload() 也不触发重绘,用户看到缩略图挂着,点上传按钮仍可能发空请求(尤其在 auto: false 下)。
必须三步一起做,缺一不可:
-
uploadInst.files = []:清掉实例内部队列 -
uploadInst.config.elem.next('.layui-upload-list').html(''):干掉预览 DOM -
uploadInst.reload():重绘组件,恢复“未选中”视觉态
漏掉任何一步,UI 和逻辑都会错位。比如只清 DOM 不 reload,按钮文字还是“重新选择”,但实际已无文件可传。
form.reset() 或清空 input.value 对 layui upload 完全无效
有人试过 document.getElementById('xxx').value = '' 或 form.reset(),结果毫无反应——因为 layui 的上传组件是完全接管的:它监听原生 input[type="file"] 的 change 事件,把文件存进 JS 实例,和 DOM 的 value 属性彻底解耦。
现代浏览器也禁止 JS 修改 input[type="file"] 的 value,设了也白设,控制台还可能报错。
更危险的是直接操作 uploadInst.config.files 或 this.files:
– 删除整个对象会导致后续点击上传按钮仍发请求
– 强行 delete this.files[x] 可能触发内部状态判断异常,弹窗崩溃
单文件场景下更简单:每次只留最后一个
如果你明确只要单文件(没开 multiple: true),choose 里拿到的 obj.files 是长度为 1 的 FileList,但要注意 IE9- 兼容性下它可能是 undefined,得 fallback 到原生表单提交逻辑。
推荐做法是忽略 obj.files,专注 obj.pushFile() 返回的对象:
- 取
Object.values(obj.pushFile())[0]得到最新文件 - 清空全局
UPLOAD_FILES后,只存这一个 - 后续上传、校验、显示都基于这个唯一引用
这样既避免多选干扰,又绕开了 number: 1 这类无效配置的误导。真正起效的,永远是 multiple 的有无,不是数字参数。


















