data 配置必须是函数而非对象，确保每次上传前动态获取最新值；多文件无法单独传参，需后端统一处理或改用 before 回调+FormData；auto: false 可控上传时机；后端需用对应方式接收 form-data 中的普通字段。
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 能把上传时机完全交到你手上：等用户填完表单、点“确认上传”按钮时再调用 upload.start()，这时 data 函数才执行，值一定是最新的。
- 按钮上可加
data-params='{"bizId":"abc","field":"cover"}'，然后在data函数里解析 - 或者渲染前用
var ctx = {bizId: xxx, field: yyy}，再写data: function() { return ctx; }（适用于单次上传场景） - 多个上传区需各自独立
ctx变量，避免互相覆盖
后端收不到 data 参数？检查 multipart/form-data 解析逻辑
data 字段会作为普通 form 字段发送，和文件同级，不是嵌套在 JSON 里——别指望用 req.body.params 拿到。
常见问题：
- Spring Boot 默认不自动合并 form-data 中的非文件字段，要用
@RequestParam显式接收 - PHP 需用
$_POST读取，不是$_GET或json_decode(file_get_contents('php://input')) - Node.js 的
multer中，fields或any()才能同时捕获文件和普通字段 - 如果后端只认 JSON，就别用
data，改用before钩子手动拼FormData（但代价是失去 layui 自动处理file字段的能力）
最常被忽略的一点：data 函数返回的对象，键名必须和服务端约定的字段名严格一致，大小写、下划线都不能错，且不能含空格或特殊字符。
