data必须是函数，不能写成静态对象；正确写法为data: {userId: function(){ return $('#userId').val(); }}，该函数在每次上传前执行以获取最新值。
data必须是函数，不能写成静态对象
直接写 data: {userid: $('#userid').val()} 是无效的——这行代码只在 upload.render() 初始化时执行一次，后续 input 值变了，参数还是旧的。layui 不会自动监听 dom 变化。
正确做法是把值读取逻辑封装进函数：data: {userId: function(){ return $('#userId').val(); }}。这个函数会在每次真正发起上传请求前被调用，确保拿到最新值。
- 函数内部
this指向 upload 实例，不是触发按钮或表单，别写$(this).find('[name=uid]').val()这类代码，会报错 - 如果要读取按钮上的上下文（比如
data-biz-id="1001"），可用layui.$(this.elem).attr('data-biz-id') - 避免在
choose回调里反复赋值obj.config.data，Layui 不会重新读取该属性
多文件上传时每个文件带不同参数怎么办
Layui 的 data 是全局生效的，它不会为队列中每个文件单独执行一次函数。也就是说，你无法靠 data 配置让第 1 个文件传 {type: 'cover'}、第 2 个传 {type: 'thumb'}。
真有这种需求，有两个务实路径：
- 后端统一接收所有文件，再按顺序或文件名匹配对应元数据（前端在
choose里存好fileMeta[index] = {type: 'cover'}，上传成功后补发描述信息） - 放弃
data，改用before回调 + 原生FormData手动构造请求（但会失去upload自动处理 file 字段的能力，需自己 append 文件） - 不要强行拆成多次单文件上传——并发控制、进度条、错误重试都会变复杂
auto: false 是动态参数可靠的前提
设了 auto: true 却发现参数没更新，大概率是因为用户刚输完内容就点了“选择文件”，此时 data 函数还没来得及读取新值，上传已触发。
推荐始终设 auto: false，用显式按钮控制上传时机：
-
bindAction指向的按钮点击时，data函数才被执行 - 确保该按钮不在
form标签内，否则可能触发表单默认提交，中断上传流程 - 如果用了
before回调做校验，返回false或Promise.reject()能可靠拦截上传，比依赖data更可控
后端收不到 data 参数？检查 form-data 解析方式
data 里的字段是以普通 form 字段形式和文件同级提交的，不是嵌套在 JSON body 里。很多后端框架（如 Spring Boot）默认不从 multipart/form-data 中提取非文件字段。
确认后端是否支持以下任一方式：
- Java：用
@RequestParam接收字符串字段，而非@RequestBody - PHP：直接读
$_POST['userId']，不是json_decode(file_get_contents('php://input')) - Node.js：确保中间件（如
multer）配置了fields或any()，能解析额外字段
最常被忽略的是：后端返回的响应体必须是纯 JSON，且含 code 字段（0 表示成功），否则 done 回调根本不会触发，你以为参数没传过去，其实是整个上传流程卡在了响应解析环节。
