讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

Seko
Seko

AI短剧一键生成成片

立刻MV
立刻MV

低成本歌曲 MV、视频生成

剧云
剧云

中文短剧剧本制作平台

HTML5FormData上传附带参数_HTML5multipartform-data拼接额外字段操作【指南】

陌墨同学_5418

陌墨同学_5418

发布时间:2026-02-27 19:13:03

|

281人浏览过

|

来源于php中文网

原创

html5formdata上传附带参数_html5multipartform-data拼接额外字段操作【指南】

FormData.append() 怎么加非文件字段

直接用 append() 就行,和加文件没区别,但很多人误以为要“拼接字符串”或手动构造 boundary —— 完全没必要。

浏览器原生 FormData 会自动处理 multipart/form-data 编码,包括字段名、值、类型、分隔符。你只管塞进去,它负责组装。

  • formData.append('user_id', '123'):传字符串,自动当 text/plain
  • formData.append('profile', fileInput.files[0]):传 File 对象,自动带 filename 和 content-type
  • formData.append('metadata', JSON.stringify({role: 'admin'})):传 JSON 字符串也 OK,后端按普通字段收

后端收不到额外字段?检查 Content-Type 是否被手动覆盖

常见错误:用 fetch 或 XMLHttpRequest 发送时,手贱写了 headers: {'Content-Type': 'multipart/form-data'} —— 这会导致失败。

原因:multipart/form-data 请求必须带 boundary,而浏览器自动生成的 Content-Type 是类似 multipart/form-data; boundary=----WebKitFormBoundaryxxx 的格式。你硬设一个没 boundary 的 header,服务端就解析不了。

立即学习“前端免费学习笔记(深入)”;

DeepBI DHTML 页面生成器
DeepBI DHTML 页面生成器

生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur

下载
  • ✅ 正确做法:不设 Content-Type,让浏览器自己填
  • ❌ 错误写法:headers: {'Content-Type': 'multipart/form-data'}
  • 如果用了 axios,别配 headers 里的 Content-Type,更别设 transformRequest 干预 FormData

上传大文件时附带参数,会不会影响进度监听

不影响。所有字段(包括字符串、Blob、File)都会统一走二进制流传输,XMLHttpRequest.upload.onprogress 或 fetch + ReadableStream(需额外封装)监听的是整个请求体的发送进度,不是“只监文件”。

但注意:如果你在 append() 里塞了超大字符串(比如几 MB 的 base64 图片),它也会被当成二进制块发出去,占用带宽、拖慢整体上传节奏,还可能触发内存警告。

  • 避免把图片转 base64 再塞进 FormData;直接塞 Blob 或 File
  • 字符串字段控制在几 KB 内,比如 token、id、简单 JSON
  • Node.js 后端用 busboy 或 multer 接收时,字段和文件是分开触发事件的,顺序不一定,别假设“字段一定先到”

兼容性与边界情况:IE11 和 Safari 旧版的坑

FormData 本身 IE10+、Safari 5.1+ 都支持,但部分行为不一致:

  • IE11 不支持直接 append() 二进制 Blob(如 new Blob(['abc'])),但支持 File 对象 —— 所以动态生成的非文件内容,最好转成 new File([str], 'field.txt') 再塞
  • Safari ≤ 11.1 在 fetch 中传 FormData 时,偶尔漏掉最后一个字段(尤其多字段+文件混传),加个空字段兜底:formData.append('dummy', '')
  • 所有浏览器都不支持 FormData.get() 读取已 append 的字段值(只读 API),调试时用 console.log([...formData.entries()])

复杂点在于:字段名重复、嵌套对象、数组值这些,FormData 一律扁平处理,后端得按约定解析,浏览器不管语义。

相关文章

HTML速学教程(入门课程)
HTML速学教程(入门课程)

HTML怎么学习?HTML怎么入门?HTML在哪学?HTML怎么学才快?不用担心,这里为大家提供了HTML速学教程(入门课程),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
函子Zion

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2335

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3822

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1276

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

4439

2025.09.10

登录token无效
登录token无效

登录token无效解决方法:1、检查token的有效期限,如果token已经过期,需要重新获取一个新的token;2、检查token的签名,如果签名不正确,需要重新获取一个新的token;3、检查密钥的正确性,如果密钥不正确,需要重新获取一个新的token;4、使用HTTPS协议传输token,建议使用HTTPS协议进行传输 ;5、使用双因素认证,双因素认证可以提高账户的安全性。

15406

2023.09.14

登录token无效怎么办
登录token无效怎么办

登录token无效的解决办法有检查Token是否过期、检查Token是否正确、检查Token是否被篡改、检查Token是否与用户匹配、清除缓存或Cookie、检查网络连接和服务器状态、重新登录或请求新的Token、联系技术支持或开发人员等。本专题为大家提供token相关的文章、下载、课程内容,供大家免费下载体验。

1785

2023.09.14

token怎么获取
token怎么获取

获取token值的方法:1、小程序调用“wx.login()”获取 临时登录凭证code,并回传到开发者服务器;2、开发者服务器以code换取,用户唯一标识openid和会话密钥“session_key”。想了解更详细的内容,可以阅读本专题下面的文章。

4337

2023.12.21

token什么意思
token什么意思

token是一种用于表示用户权限、记录交易信息、支付虚拟货币的数字货币。可以用来在特定的网络上进行交易,用来购买或出售特定的虚拟货币,也可以用来支付特定的服务费用。想了解更多token什么意思的相关内容可以访问本专题下面的文章。

6481

2024.03.01

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

0

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
GDB 17.2 官方文档集合
GDB 17.2 官方文档集合

共0课时 | 0人学习

Bootstrap 入门安装配置
Bootstrap 入门安装配置

共0课时 | 0人学习

38+ PhpStorm 提示和技巧
38+ PhpStorm 提示和技巧

共1课时 | 239人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn