Layui上传组件如何设定强制单文件上传

Layui upload 默认单文件，多选源于 multiple 属性被启用：需同时检查并清除 JS 配置中的 multiple: true 和 HTML 中 input 的 multiple 属性，避免 choose 回调中累积文件，auto: false 不影响单多选逻辑。

为什么默认就是单文件，却还会多选

layui upload 组件默认行为就是单文件上传，根本不需要额外配置“限制”——只要你没主动启用多选。问题通常出在配置或 dom 层面被悄悄打开了 multiple 开关。

• multiple: true 显式写在 upload.render() 配置里
• HTML 中绑定的 <input type="file"> 元素自带 multiple 属性（Layui 会读取它）
• IE9– 环境下因 files API 缺失，Layui 降级逻辑导致行为异常（但官方已不维护该环境）

检查并清除 multiple 的两种位置

必须同时确认 JS 配置和 HTML 源码，任一地方残留都会触发多选：

• JS 初始化中删掉 multiple: true，确保只保留 multiple: false 或干脆不写（默认即 false）
• 如果用了自定义触发元素（如 <button id="uploadBtn">），DOM 里不该出现 <input>；如果用了 bindAction 或显式写了 <input id="LAY_upload_input" multiple>，务必删掉 multiple 属性

choose 回调里别手动累积文件

有人想“先选再统一上传”，于是在 choose 回调里把 obj.files 存进数组，结果每次选择都追加——这不是 Layui 多选，是你自己缓存逻辑没清空。

• 不要在 choose 里做 selectedFiles.push(...) 这类操作
• 真要干预，就直接用 obj.files[0]，或设 selectedFile = obj.files[0]，每次覆盖而非追加
• 若需用户二次确认，也应在 choose 里立刻调 obj.upload()，而不是留着等点击按钮

auto: false 不等于允许多选

设 auto: false 是为了手动控制上传时机，和是否多选无关。它只影响“选完后是否立即发请求”，不影响选择阶段的行为。

• auto: false + multiple: false → 用户只能选一个，点上传按钮才发
• auto: false + multiple: true → 用户能选多个，但你得自己处理批量逻辑（见多文件方案）
• 别误以为关掉 auto 就自动变成单文件——multiple 才是开关

强制单文件的关键不在“加限制”，而在“去掉所有让多选生效的痕迹”。最容易被忽略的是 HTML 层那个静默的 multiple 属性，它比 JS 配置更优先，且肉眼难查。