<p>Layui upload 组件默认单文件选择，无需额外限制；若出现多选现象，通常因配置了 multiple: true、HTML 中 input 标签含 multiple 属性、choose 回调中重复缓存文件或 IE9- 兼容性退化导致。</p>
layui upload 组件默认就是单文件选择，不用额外限制
很多人以为要加什么参数才能“禁止多选”，其实 layui.upload 默认行为就是只允许选一个文件——前提是没手动开启 multiple。浏览器原生的 <input type="file"> 在没加 multiple 属性时，系统文件选择器天然就只让你勾一个。
所以真正的问题往往不是“怎么限制”，而是“为什么看起来能选多个”：
- 你可能在初始化 upload 时传了
multiple: true - 或者 DOM 上的
<input>标签本身带了multiple属性（Layui 会读取它） - 也可能是用了
choose回调里手动 push 到数组，造成“累积上传”的错觉
检查并清除 multiple 相关配置
最直接的办法是翻你初始化 upload 的代码，确认没有主动启用多选：
layui.upload({
elem: '#uploadBtn',
url: '/upload',
// ✅ 确保这里没有写 multiple: true
// ✅ 也不要有 auto: false + 手动触发多次 choose 的逻辑
done: function(res){
console.log('只上传了一个：', res);
}
});
同时检查 HTML 中对应按钮或隐藏 input：
- 如果用的是自定义触发元素（比如
<button id="uploadBtn">），那 DOM 里不需要<input>，自然不会有多选问题 - 如果用了
bindAction或显式写了<input type="file" id="LAY_upload_input">，务必确认它没带multiple属性
避免在 choose 回调里重复绑定或缓存文件
有人想“先选再统一上传”，于是在 choose 回调里把 obj.files 存起来，结果发现每次选都追加——这是因为 obj.files 是 FileList，而 Layui 每次触发 choose 都是全新实例，但你的变量没清空。
正确做法很简单：
- 不依赖
choose回调做文件暂存，让 Layui 自己处理单次选择流 - 真要干预，也在
choose里立刻调用obj.upload()，不要留接口等二次点击 - 如果必须手动控制，那就每次
choose先清空已有引用：selectedFile = null; selectedFile = obj.files[0];
注意 IE9 及以下的兼容性假象
Layui 官方已不支持 IE9-，但如果你还在维护老项目，要注意：IE9 的 file input 不支持 files API，obj.files 是 undefined，此时 Layui 会退回到 form submit 模式——而这个模式下用户点几次按钮就发几次请求，看起来像“能传多个”，其实是多次独立提交。
这种情况下：
- 无法靠前端 JS 限制“只能选一个”，因为底层机制不同
- 后端必须对重复请求做幂等判断（比如校验文件名、大小、MD5）
- 更现实的做法是明确提示“请使用 Chrome / Firefox / Edge 浏览器”
现代浏览器里，只要没碰 multiple，用户点一次选择框，就只能勾一个文件——这个限制来自操作系统级文件对话框，Layui 只是顺手用了它。
