You need to enable JavaScript to run this app. 如何向FormData追加Blob时避免隐式生成文件名以适配PHP后端
优惠活动
大模型
产品
解决方案
定价
更多

如何向FormData追加Blob时避免隐式生成文件名以适配PHP后端

FormData追加Blob时规避隐式文件名的实现方案

底层逻辑说明

浏览器执行formData.append()追加Blob类型值时的序列化规则,是完全按照W3C标准写死的:

  • 省略第三个参数时,浏览器会自动为Blob生成默认的filename="blob",写入请求段的Content-Disposition头
  • 传入任意非空值作为第三个参数时,浏览器会把这个值转成字符串,作为自定义文件名写入Content-Disposition
  • 传入null/undefined等空值时,浏览器会强制将这些值转成字符串,最终生成filename="null"这类无效文件名

只要multipart请求段中带了filename属性(无论属性值是什么),PHP的multipart解析器就会判定这是文件上传字段,自动将二进制内容保存为临时文件,映射到$_FILES数组;只有完全不携带filename属性的multipart段,才会被识别为普通表单字段,将内容映射到$_POST数组。

注意:不要尝试传入空字符串作为第三个参数,这种方式生成的filename=""字段依然会被PHP识别为文件上传,完全达不到预期效果。FormData对象的内置实现没有提供任何配置项,可以让追加Blob时完全省略filename字段。

可行实现方案

完全跳过FormData的自动序列化逻辑,手动按照multipart规范拼装请求体,全程控制请求段的头信息:

  • 自定义生成multipart分隔符,避免和内容本身的字符冲突
  • 拼装每个表单字段的请求段,对于Blob对应的字段,在Content-Disposition头中只写name属性,完全不添加filename字段
  • 将所有段和Blob内容合并为完整的请求体,发送时设置匹配的Content-Type头

示例代码:

// 生成分隔符
const boundary = `----formDataBoundary${Date.now()}`;
// 按顺序拼装所有请求段
const requestParts = [
  // 普通文本字段,写法和标准FormData一致
  `--${boundary}\r\nContent-Disposition: form-data; name="field_name"\r\n\r\nfield_value\r\n`,
  // Blob对应的字段,完全不写filename属性
  `--${boundary}\r\nContent-Disposition: form-data; name="binary_data"\r\nContent-Type: application/octet-stream\r\n\r\n`,
  blobObj,
  `\r\n--${boundary}--\r\n`
];
// 生成最终请求体
const requestBody = new Blob(requestParts, {
  type: `multipart/form-data; boundary=${boundary}`
});
// 发送请求
fetch('/api/endpoint', {
  method: 'POST',
  headers: {
    'Content-Type': requestBody.type
  },
  body: requestBody
});

这种方式发送的请求,对应的Blob段完全不带filename属性,PHP后端会自动将这部分的二进制内容解析到$_POST['binary_data']中,不会触发临时文件保存逻辑,也不会生成对应的$_FILES条目。

内容的提问来源于stack exchange,提问作者張俊芝

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.03 09:45:02