data配置项是唯一可靠入口，所有额外参数必须显式传入，支持静态对象和函数两种形式；函数形式每次上传前执行，可动态取值；token等认证字段须通过before回调设headers，不可塞入data。
data 配置项是唯一可靠入口
Layui upload 不会自动抓取表单字段，所有额外参数必须显式通过 data 配置传入。它支持两种形式：静态对象（适合固定值）和函数（适合动态取值）。别指望在 done 回调里直接拿到你“想传的参数”——done 只接收服务端返回内容、当前文件索引和 upload 实例，不透传你传进去的业务数据。
-
data写成对象时，值在upload.render()执行时就被固化，后续表单修改不会生效 -
data写成函数时，每次上传前都会执行，此时this指向当前 upload 实例，可用于动态读取 DOM 状态 - 函数内不能直接用
$(this).find(...)——this是 layui 实例，不是 jQuery 对象；要用layui.$(this.elem)或提前绑定上下文
动态取值必须用 before 或 data 函数，别在 choose 里赋值
常见错误是把参数获取逻辑塞进 choose 回调，比如 choose: function() { this.data = { id: $('#id').val() } } —— 这完全无效。choose 不参与请求组装，改 this.data 不会影响实际发送的参数。
- 正确做法是把取值逻辑放进
data函数：data: function() { return { bizId: $('#bizId').val(), field: $('input[name="field"]').val() }; } - 或放进
before回调：before: function() { this.data = { ... }; }，效果等价但更显式 - 如果页面有多个上传区域，每个区域需独立定义
data函数或变量，避免闭包捕获错乱
后端收不到 data 参数？检查 form-data 解析方式
前端通过 data 传的参数会作为 form-data 的普通字段（key-value）一起提交，但很多后端框架（如 Spring Boot）默认不从 form-data 中解析非文件字段，只从 query 或 JSON body 提取。
- Spring Boot 需加
@RequestParam显式接收，不能只靠@RequestBody - PHP 的
$_POST能直接拿到，但注意文件字段在$_FILES，其他字段在$_POST - Node.js 的
multer默认只处理文件，额外字段需配置fields或用single('file')+body-parser组合
token 和业务参数别混在一块儿
data 专管业务参数（如 type、recordId），认证类字段（如 token）必须走 headers，且只能在 before 回调里动态设置。
-
headers在render时固化，写死会失效；只有before里赋值才保证每次请求都用最新 token before: function() { const t = sessionStorage.getItem('token'); if (!t) return false; this.headers.Authorization = 'Bearer ' + t; }- 把 token 塞进
data既不安全，也违反接口规范，后端鉴权逻辑可能直接忽略
this 不是 DOM 元素，也不是 jQuery 对象，它只是 layui upload 实例；而后端是否能正确提取 form-data 中的混合字段，取决于你用的框架和具体配置，不是前端传了就一定收得到。
