layui upload 的 data 选项必须为函数而非静态对象，以确保每次上传时动态获取最新值；多文件需用 choose 回调存元数据，auto: false 配 bindAction 控制时机；参数须为扁平字符串，复杂结构应通过文件名传递。
data 参数必须是函数，不能直接写对象
layui upload.render() 的 data 选项不接受静态对象（比如 {userid: '123', type: 'doc'}），否则参数根本不会发到后端。必须用函数形式，让 layui 在每次上传时调用它动态取值。
常见错误：写成 data: {userId: $('#userId').val()} —— 这行代码只在 render 初始化时执行一次，后续 input 值变了也不会更新。
- 正确写法是
data: {userId: function(){ return $('#userId').val(); }} - 如果要传文件名或索引，可用
data: {fileName: function(index, file){ return file?.name || ''; }} - 函数里可访问
index（当前文件序号）和file（File 对象），但注意file只在choose回调之后才稳定存在
多文件上传时，每个文件带不同参数怎么处理
layui 默认把整个文件队列一次性 POST 到接口，data 函数是全局生效的，没法为每个文件单独配一套参数。真要实现“每张图带各自 ID 或备注”，得改后端接收逻辑，或前端拆成单次请求。
更实际的做法是：把额外参数拼进表单字段，而不是依赖 data。比如在 choose 回调里，把每个文件对应的信息存进数组，上传成功后统一提交描述数据：
var fileMeta = [];
choose: function(obj) {
this.files = obj.pushFile();
Array.from(obj.files).forEach((file, i) => {
fileMeta[i] = {
name: file.name,
remark: prompt('请为 ' + file.name + ' 添加备注？') || ''
};
});
},
done: function(res, index, upload) {
// 上传成功后，fileMeta[index] 就是这条记录的元信息
console.log('第', index, '个文件元数据:', fileMeta[index]);
}
这样既避免了前端强行拆包上传，又保证了前后端语义对齐。
auto: false 时，bindAction 按钮触发上传才真正走 data
很多人设了 data 却发现参数没传过去，其实是误用了 auto: true。一旦开启自动上传，choose 回调一结束就立刻发请求，此时 data 函数可能还没来得及读取最新 DOM 值（比如用户刚输完内容就点了文件选择）。
- 推荐始终设
auto: false，用显式按钮控制上传时机 -
bindAction指向的按钮点击时，layui 才会调用data函数并发起请求 - 确保按钮不在
form标签内，否则可能触发表单默认提交，中断上传
后端收不到 data 参数？先检查 Content-Type 和 multipart 边界
layui 上传默认用 multipart/form-data，但如果你在 data 里塞了复杂嵌套对象或 JSON 字符串，后端解析会失败——因为 multipart 不支持深层结构，所有 data 字段都只是扁平的 form key-value。
典型翻车点：
- 写
data: {config: JSON.stringify({a:1})}→ 后端收到的是字符串字面量，不是 JSON 对象 - 写
data: {'user[id]': '123'}→ PHP 可能自动转成数组，但 Java Spring Boot 默认不识别这种语法 - 解决办法：所有参数必须是简单字符串、数字；复杂结构应由后端从文件名、路径或额外接口中推导
最稳妥的额外参数传递方式，其实是把关键标识塞进文件名（如 report_20260421_user123.pdf），后端按规则提取，比依赖 data 更可靠。
