data必须为函数，确保每次上传前获取dom最新值；auto必须设为false，配合bindaction按钮控制上传时机；多文件时data函数只执行一次，无法为单个文件设不同参数。

必须用 data 配置项传，且动态值必须写成函数，不能直接写对象字面量。

data 必须是函数，否则拿不到最新输入值

常见错误：data: {userId: $('#userId').val()} —— 这行代码只在 upload.render() 执行时求值一次，后续 input 内容变了，上传参数还是旧的。

• 正确写法是把取值逻辑包进函数：data: {userId: function(){ return $('#userId').val(); }}
• 这个函数会在每次真正发起上传请求前被调用，确保拿到当前 DOM 的最新值
• 函数内 this 指向 upload 实例，不是按钮或表单，所以 $(this).find(...) 会报错
• 如果要读触发按钮上的上下文（比如 data-biz-id="1001"），用 layui.$(this.elem).attr('data-biz-id')

auto: false 是动态参数生效的前提

设了 auto: true 却发现参数没更新？大概率是用户刚输完内容就点了“选择文件”，此时 data 函数还没来得及执行，上传已触发。

深蓝色网站后台管理系统layui框架模板-AdminPro

一款深蓝色网站后台管理系统layui框架模板

下载

• 推荐始终设 auto: false，用显式按钮控制上传时机（bindAction 指向的按钮点击时才执行 data 函数）
• 确保该按钮不在 form 标签内，否则可能触发表单默认提交，中断上传流程
• 如果用了 before 回调做校验，返回 false 或 Promise.reject() 能比依赖 data 更可靠地拦截上传

done 回调里拿不到你传的额外参数

done 只接收服务端返回的数据、index 和 upload 实例，不会自动透传你在 data 里塞的字段。

• 别在外部定义变量然后在 done 里读——多文件并发时闭包捕获的是最后一次赋值，会错乱
• 想在上传成功后知道“这次传的是哪个业务 ID”，只能靠后端返回时带上对应标识，或前端在 choose 回调里存好映射关系（如 fileMeta[index] = {bizId: 'abc'}），上传成功后再补发描述信息
• 后端收不到 data 字段？因为它是以 multipart/form-data 的 key-value 形式提交的，Spring Boot 等框架默认不自动解析 form-data 中的非文件字段，需显式用 @RequestParam 接收

最易被忽略的一点：多文件上传时，data 函数对所有文件都只执行一次，无法为每个文件单独配不同参数。真有这种需求，要么后端按顺序匹配，要么放弃 upload.render，改用 choose + 原生 FormData + fetch 手动构造请求。