drag: true 必须显式配置，否则拖拽逻辑不初始化；elem需有可见样式且渲染完成后再调用render；auto与bindAction配合错误、URL不可访问、后端未正确处理多文件、CSS遮挡或未处理choose回调均会导致失败。

drag: true 必须显式配置，否则拖拽区完全不响应

layui.upload 默认关闭拖拽功能，哪怕你写了 elem、加了边框、绑了事件，只要没写 drag: true，整个拖拽逻辑压根不会初始化——这不是 bug，是设计如此。它把“是否启用拖拽”当作一个明确开关。

实操建议：

• 在 upload.render() 配置对象里，必须显式写 drag: true
• elem 容器不能是空 <div>，至少设 <code>style="border: 2px dashed #999; height: 150px; padding: 20px;"，否则用户找不到可拖区域
• 若容器是弹窗、Tab 页或 JS 动态插入的 DOM，得等真实渲染完成（比如用 layui.layer 的 success 回调）再调用 upload.render()，否则绑定失效

auto 和 bindAction 配合错误会导致“拖进去了但没上传”

现象：文件拖进区域后松手，控制台无报错，done 回调也不触发——本质是上传请求根本没发出去。

原因集中在两个点：

• auto: false 时没配 bindAction，或配了但目标元素不存在（比如按钮被 JS 移除、ID 写错）
• url 地址不可访问：404、CORS 拦截、跨域 cookie 缺失，都可能导致浏览器静默丢弃请求，连 error 回调都不触发

实操建议：

• 开发阶段一律先设 auto: true，确认流程通了再关
• 若要用 auto: false，bindAction 必须指向一个真实存在的按钮，例如 bindAction: '#submitBtn'
• 打开浏览器 Network 面板，看是否真有 POST 请求发出，检查 status 和 payload

多图拖拽只收到一个？问题几乎全在后端接收逻辑

前端 multiple: true 是默认值，一般不用写；真正卡住的是后端没按数组方式处理上传字段。


layui手机车牌号码键盘代码
layui手机车牌号码键盘代码是一款基于jQuery跟layui制作的手机端车牌号码输入弹出键盘选择，支持新能源汽车车牌输入格式代码。
下载

实操建议：

• 浏览器 Network 面板里看请求 payload，确认是否真有多个 Content-Disposition: form-data; name="file"; filename="a.jpg" 字段
• PHP 后端别只取 $_FILES['file']['name'][0]，要遍历 $_FILES['file']['name'] 数组
• Node.js + multer 要用 upload.array('file')，不是 upload.single('file')
• Spring Boot 须用 MultipartFile[] 接收，而非单个 MultipartFile
• accept: 'file' 会禁用多选，改成 accept: 'images' 或留空才能允许多文件拖拽

拖拽区点击无反应？大概率是 CSS 遮挡或未处理 choose 回调

拖拽区通常也兼作点击选择文件区，点了没反应，往往不是 JS 错了，而是样式穿透出了问题。

常见原因：

• 父容器用了 overflow: hidden
• 拖拽区自身 z-index 太低，被其他层盖住
• 用了 pointer-events: none（比如某些遮罩层）

实操建议：

• 给拖拽容器加 cursor: pointer 和浅色背景，肉眼确认它“可点”
• 用浏览器开发者工具检查 computed styles，重点看 pointer-events 和 z-index
• 如果用了 choose 回调做预览，记得调用 obj.preview()，否则图片不会加载到页面上
拖拽上传看着简单，但每个环节都可能断在看不见的地方：配置项漏写、DOM 时机不对、后端字段名不匹配、CSS 层级吃掉点击……最常被跳过的就是 drag: true 这一行，而它恰恰是整条链路的起点。