data必须是函数，否则无法获取实时DOM值；多文件需在choose回调中维护元数据映射；后端须正确解析multipart/form-data中的普通字段。
data 必须是函数，不能写死对象
直接写 data: {userId: $('#userId').val()} 是错的——这行代码只在 upload.render() 初始化时执行一次，后续 input 值变了，参数还是旧的。后端收不到最新值，调试时容易误以为“传了但没收到”。
正确做法是把取值逻辑包进函数里：data: {userId: function(){ return $('#userId').val(); }}。layui 会在每次上传前调用这个函数，确保拿到实时 DOM 值。
如果你需要根据文件动态生成参数（比如带文件名或序号），函数签名支持两个参数：function(index, file)，其中 file 只在 choose 回调触发后才稳定可用。
多文件上传时每个文件带不同参数？别硬塞 data
layui 的 data 是全局生效的，它对整个文件队列统一应用同一套键值对。你没法让第 1 个文件发 {type: 'avatar'}，第 2 个发 {type: 'cover'}——data 函数返回的始终是同一个对象。
真要实现 per-file 元数据，推荐在 choose 回调里存一份映射：
choose: function(obj) {
this.files = obj.pushFile();
Array.from(obj.files).forEach((file, i) => {
fileMeta[i] = {
name: file.name,
remark: prompt('备注？') || ''
};
});
},
done: function(res, index) {
console.log('第', index, '个文件的备注：', fileMeta[index]?.remark);
}
这样既不破坏 layui 默认上传流程，又能让前后端语义对齐。后端按顺序接收文件，前端按索引查元信息即可。
后端收不到 data 参数？检查 form-data 解析方式
layui 的 data 字段会作为普通 form 字段，和文件同级提交到 multipart/form-data 请求体中。不是 JSON，也不是 query string。
常见踩坑点：
- Spring Boot 用
@RequestParam接，别用@RequestBody - PHP 直接读
$_POST['xxx']，不是$_FILES['xxx'] - Node.js 的
multer需配置fields或any()，否则非文件字段会被忽略
如果后端框架默认只解析 JSON body，那就别碰 data，改用 before 钩子手动构造 FormData，但要注意：一旦 return false，layui 就不再接管上传，得自己处理全部逻辑。
想改文件名、加 token 或控制并发？before 是唯一入口
before 是上传前最后可干预的钩子，适合做三件事：
- 动态设置
this.data（比 render 时的data更灵活，且能访问obj实例） - 预览文件（
obj.preview()）、显示 loading（layer.load()） - 拦截并改用 fetch / axios 自定义上传（比如合并多个文件、加认证 header、串行上传防并发）
例如控制并发数量，就不能依赖 layui 默认的并行行为——它会为每个文件发一个独立请求，20 个文件就是 20 次 AJAX。这时要在 choose 缓存文件列表，再用 fetch 手动拼 FormData 发一次请求，后端需支持 files[] 这样的数组字段。
真正难的从来不是怎么传参，而是传参之后，前后端对“谁是谁”的理解是否一致。尤其当文件批量上传、用户中途修改表单、页面存在多个 upload 实例时，闭包变量污染、this 指向错乱、索引偏移，都比参数本身更致命。
