layui upload 的 data 配置项用于携带额外参数，以 formdata 方式自动附加到请求中；必须为对象（非函数或字符串），动态更新需用 upload.reload()，字段名不可与文件字段冲突，后端须按表单方式解析。
layui upload 的 data 配置项就是干这个的
layui 的 upload.render() 支持在上传请求中携带额外参数，核心靠 data 字段，它会自动以表单字段（FormData）方式附加到请求体里，后端能直接按 name 读取。
-
data必须是普通对象，不能是 JSON 字符串或函数（除非你手动处理） - 值为
undefined或null的字段会被忽略，不会发到服务端 - 如果要动态传参（比如用户选了某个下拉框后再上传），得在触发上传前用
upload.reload()更新data - 注意：
data中的字段名不能和文件字段名（默认file）冲突，否则可能被覆盖
怎么在点击按钮时动态塞参数（比如带 token 或业务 ID）
常见场景是用户登录后上传，需附带 token；或上传图片关联某条记录，需传 article_id。这时不能写死在 render 初始化里，得用 upload.reload() 刷新配置：
let uploadInst = upload.render({
elem: '#uploadBtn',
url: '/api/upload',
auto: false, // 关闭自动上传
bindAction: '#submitBtn', // 指定触发按钮
data: { type: 'avatar' } // 初始静态参数
});
// 用户操作后（如选择文章、登录完成），更新参数再上传
$('#submitBtn').on('click', function(){
const token = localStorage.getItem('token');
const articleId = $('#article-select').val();
upload.reload(uploadInst.config.id, {
data: {
type: 'avatar',
token: token,
article_id: articleId
}
});
});
后端接收不到 data 字段？检查这几点
参数“发了但收不到”基本不是 layui 问题，而是前后端协作细节没对齐：
- 后端是否用的是表单解析方式？例如 Node.js 的
busboy、PHP 的$_POST、Java 的@RequestParam—— 这些才能拿到data里的字段；如果后端强行解析 raw body 为 JSON，就收不到 - 确认上传接口没被 Nginx 或网关拦截 multipart 请求（比如设置了
client_max_body_size或禁用了multipart/form-data） - 浏览器开发者工具 Network → 查看该请求的 Form Data 标签页，确认参数确实出现在里面（而不仅是 Request Payload）
- layui 默认文件字段名是
file，如果你改过field配置（如field: 'img'），后端读文件时也得对应改名，否则可能连文件都拿不到
想传数组或嵌套对象？别硬塞，先扁平化
data 对象只支持一层 key-value，不支持嵌套结构（如 {user: {id: 1, name: 'a'}}）。浏览器 FormData 本身就不支持嵌套，后端收到的会是字符串 [object Object]。
- 需要传数组时，用重复 key：比如
{tag: ['a','b']}→ 手动转成{'tag[]': 'a', 'tag[]': 'b'}（注意部分后端框架如 PHP 自动识别[]，Spring Boot 需显式声明@RequestParam List<string> tag</string>） - 复杂结构建议序列化成 JSON 字符串再传：
data: { meta: JSON.stringify({version: 2, author: 'x'}) }，后端再解析 - 避免在
data里传大块数据（如 base64 图片），会导致表单体积暴增、超时或被中间件截断
data 看似简单，但动态更新时机、后端解析方式、字段命名冲突这三点最容易卡人；尤其当多个上传组件共存时，upload.reload() 的 id 参数漏传或传错，参数就静默失效了。
