done回调无法直接获取额外参数，需通过data配置项传入；data支持对象或函数形式，函数中this指向upload实例；后端需正确解析form-data中的非文件字段。
upload 的 done 回调里拿不到额外参数？
因为 done 只接收服务端返回的数据、index 和 upload 实例，不自动透传你传进去的参数。想在上传成功后知道“这次传的是哪个表单字段”或“属于哪个业务id”，得自己想办法带进去。
常见错误是直接在 upload.render() 外部定义变量，然后在 done 里读——这在多文件并发上传时会错乱，因为闭包捕获的是最后一次赋值。
- 正确做法：用
upload.render()的data配置项传静态参数（如{type: 'avatar', uid: 123}） -
data支持函数形式，可动态返回对象，适合每次上传前取当前上下文（比如输入框的 value 或按钮的data-id） - 注意：函数里的
this指向 upload 实例，不能直接访问 DOM 元素，需提前绑定或通过事件委托获取
用 data 函数动态传参时 this 指向不对？
data 函数执行时，this 是 layui upload 实例，不是触发上传的按钮或表单。所以别写 $(this).closest('form').find('[name=id]').val() —— 这会报错。
推荐做法是把上下文提前存好，再塞进函数作用域：
- 给触发按钮加
data-params='{"bizId":"abc","field":"cover"}'，然后在data函数里用layui.$(this.elem).attr('data-params')解析 - 或者渲染 upload 前，用
var ctx = {bizId: xxx, field: yyy}，再写data: function() { return ctx; }（适用于单次上传场景） - 如果要支持多次独立上传（比如一个页面多个上传区），每个区域用独立的
ctx变量，避免互相覆盖
后端收不到 data 里的参数？
因为 data 默认走 form-data 的 key-value 形式提交，但有些后端框架（比如 Spring Boot）默认只从 query 或 body JSON 解析，不自动合并 form-data 里的额外字段。
检查点：
- 确认后端接口是否明确接收 multipart/form-data，并能读取非文件字段（例如 Java 用
@RequestParam，PHP 用$_POST） - Layui 的
data字段会作为普通 form 字段发送，和文件同级，不是嵌套在 JSON 里——别指望用req.body.params拿到 - 如果后端只认 JSON，就别用
data，改用before钩子手动拼接 FormData（但会失去 layui 自动处理 file 字段的能力）
上传前要改文件名或加 token 怎么办？
data 只负责传键值对，不干预文件本身。想改名或加认证头，得用 before 钩子 + 自定义 XHR。
但注意：一旦用了 before 并 return false，layui 就不再接管上传逻辑，全部要你自己写。容易踩的坑：
- 没手动 append 文件到 FormData，导致后端收不到文件
- 没设置
contentType: false和processData: false，XHR 把 FormData 序列化成字符串发出去，后端解析失败 - token 放 header 里的话，要确保后端允许该 header（CORS 配置
Access-Control-Allow-Headers）
简单场景（比如只加个 token 字段）仍建议走 data；真要改文件名或控制 headers，就接受要自己 handle XHR 的事实。
最常被忽略的是：Layui 的 data 不支持异步取值（比如等一个 API 返回 token 后再上传），遇到这种需求，必须用 before + 手动 XHR，且要自己管理 loading 状态和错误提示。
