必须显式配置drag: true，否则拖拽区域完全不响应；还需确保elem有宽高和视觉样式、DOM渲染完成后再初始化、auto与bindAction配合正确、后端支持多文件接收且CSS无pointer-events遮挡。
必须显式配置 drag: true，否则拖拽区域完全不响应——这是最常被跳过的硬性条件。
drag: true 是启用拖拽的强制开关
layui.upload 默认关闭拖拽逻辑，哪怕你写了 elem、加了边框、绑了事件，只要没写 drag: true，整个拖拽监听压根不会注册。这不是 bug，是设计上的显式控制。
- 在
upload.render()配置对象中，必须包含drag: true - 不能依赖“有容器就自动启用”，也不能靠 CSS 或事件监听模拟
- 如果用的是动态弹窗或 Tab 页里的上传区，得等 DOM 真实挂载（比如
layer.open的success回调）再调用render()，否则drag不生效
auto: true 才能拖进去就发请求
拖拽松手后没上传，done 回调不触发，大概率是 auto 关了但没配好手动触发链。
- 开发阶段一律先设
auto: true，确认拖进文件 → 发请求 → 收到done全流程通了，再考虑关掉 - 若必须
auto: false，则bindAction必须指向一个真实存在的按钮（如bindAction: '#uploadBtn'），且该元素不能被 JS 移除、隐藏或display: none -
url必须可访问：404、CORS 拦截、跨域 cookie 缺失都会导致“拖进去了却静默失败”，连error回调都可能不触发
multiple 和后端接收必须匹配
前端拖多个文件，后端只收到一个？问题几乎全出在服务端没按数组处理。
- 前端
multiple: true是默认值，一般不用写；但accept: 'file'会禁用多选，要允许多文件就得改成accept: 'images'或留空 - 浏览器 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
拖拽区点击无反应？先查 pointer-events 和 z-index
拖拽区通常也兼作点击选择文件区，点了没反应，90% 是样式遮挡，不是 JS 错了。
- 检查父容器是否设置了
overflow: hidden或transform导致事件穿透异常 - 确认拖拽区自身没有
pointer-events: none（常见于某些遮罩层或 loading 蒙版） - 如果用了自定义图标或图片作为触发区，确保其
z-index足够高，没被其他元素盖住 - elem 容器不能是空
，至少要有宽高和视觉提示，例如：style="border: 2px dashed #999; height: 150px; padding: 20px;"
真正卡住的地方往往不在 JS 配置，而在 DOM 渲染时机、CSS 层叠顺序、以及后端对多文件字段的解析方式——这三处最容易被忽略，但改对一个就能让拖拽上传从“不动”变成“秒传”。
