必须在choose回调中立即用obj.pushFile()获取并保存文件队列,再手动删除键值以清空;done回调中仅删对应index键;严禁删除整个files对象或直接操作内部属性。
choose 回调里用 obj.pushFile() 拿到文件队列再清空
layui-upload 没有公开的「清空所有已选文件」api,但每次调用 obj.pushfile() 会返回一个对象,键是自动生成的 id(如 "1612418956647-0"),值是 file 实例。这个对象就是当前组件内部维护的文件队列。
关键点在于:你必须在 choose 回调里立刻保存它,否则后续无法访问——因为 layui 不暴露 this.files 给外部,且该对象只在回调生命周期内有效。
- 先声明一个全局或闭包变量(如
let UPLOAD_FILES) - 在
choose开头就执行UPLOAD_FILES = obj.pushFile() - 紧接着遍历并
delete UPLOAD_FILES[key],就能清掉上一次残留的文件 - 如果只允许单文件,建议再手动保留最后一个(即最新选中的),其余全删
done 回调中删除已上传成功的文件项
当 auto: false 时,用户点击按钮触发上传,done 是每个文件上传成功后的回调。此时 index 参数对应的就是该文件在队列里的 key(字符串),不是数组下标。
直接删 UPLOAD_FILES[index] 即可,不用遍历全部——前提是你的 UPLOAD_FILES 确实还活着(没被 GC 或覆盖)。
- 别在
done里调obj.pushFile(),它此时返回空对象 - 如果上传失败,
error回调里不删,留给用户重试 - 注意:
multiple: true时,done会多次触发,每次删一个;multiple: false时只触发一次
避免 delete this.files[x] 导致组件异常
有人尝试直接操作 uploadInst.config.files 或 this.files,但这是危险操作:layui 内部依赖这些属性做状态判断,强行 delete uploadInst.config.files 整个对象会导致后续点击上传按钮仍发请求、甚至控制台报错、弹窗崩溃。
真实踩坑现象:delete uploadInst.config.files[findex] 可行,但 delete uploadInst.config.files 会让组件“失忆”,下次点击上传按钮时,bindAction 仍会提交,且接口收不到文件字段。
- 永远只删具体 key,不要删整个
files属性 - 不要试图通过
uploadInst.config修改配置来“重置”组件 - 组件实例没有
reset()方法,别找
弹窗场景下打开前需手动清理上次选择的文件
如果 upload 渲染在模态框里(比如编辑弹窗),用户选了文件但没上传就关掉弹窗,再打开时 UI 上看不到文件,但 UPLOAD_FILES 还在内存里——下次点上传,会把“幽灵文件”一起发出去。
解决办法是在弹窗 open 事件(或 layui.layer.open 的 success 回调)里,主动清空你存的 UPLOAD_FILES,并确保 upload 实例的 config.files 也被清掉(如果它存在)。
- 推荐做法:为每个弹窗 upload 实例单独维护
UPLOAD_FILES变量,避免跨实例污染 - 关闭弹窗时,不销毁 upload 实例,但清空它的文件队列引用
- 不要依赖
layui.upload.render()自动清理——它不会
最麻烦的点其实是:layui 把文件队列藏得太深,又不提供标准清除入口。所以所有方案都绕不开「自己记、自己删」这个动作。一旦漏掉某次 choose 或 done 里的清理逻辑,文件就会悄悄堆积,直到某次上传突然多出三个重复请求。











