0

0

HTML5怎样自定义上传请求头_HTML5自定义请求头上传法【定制】

星夢妙者

星夢妙者

发布时间:2026-01-18 21:31:14

|

313人浏览过

|

来源于php中文网

原创

HTML5文件上传无法直接设置请求头,必须用XMLHttpRequest或fetch手动构造请求;XMLHttpRequest需在open后、send前调用setRequestHeader设自定义头,send FormData时浏览器自动设Content-Type;fetch不可手动设Content-Type,否则报错,且需后端正确配置CORS响应头。

html5怎样自定义上传请求头_html5自定义请求头上传法【定制】

HTML5 上传时无法直接设置请求头,必须用 XMLHttpRequestfetch

HTML5 原生的 本身不支持添加自定义请求头。点击上传触发的是浏览器默认表单提交(multipart/form-data),此时你连 Content-Type 都无法手动设——浏览器会自动加 boundary。真要带 AuthorizationX-Upload-ID 这类头,必须绕过表单提交,改用 JS 主动构造请求。

XMLHttpRequest 上传并设请求头的正确写法

这是最稳妥、兼容性最好的方式,尤其适合需要进度监听或旧版浏览器支持的场景。关键点在于:不能用 FormData.append() 后直接 send(FormData)——那样会触发浏览器自动设置 Content-Type: multipart/form-data; boundary=...,导致你之前 setRequestHeader 的头被忽略或报错(如 Chrome 报 Refused to set unsafe header "Content-Type")。

  • 先创建 XMLHttpRequest 实例
  • 调用 open("POST", url),不要设第三个参数为 false(同步已废弃)
  • open() 之后、send() 之前 调用 setRequestHeader() 设置自定义头
  • new FormData() 收集文件,但 send() 时直接传 formData 对象(此时浏览器仍会自动设 Content-Type,但这是允许的;你设的其他头如 Authorization 会保留)
const xhr = new XMLHttpRequest();
xhr.open("POST", "/upload");
xhr.setRequestHeader("Authorization", "Bearer abc123");
xhr.setRequestHeader("X-Client-Version", "2.1.0");

const formData = new FormData();
formData.append("file", fileInput.files[0]);
formData.append("meta", JSON.stringify({type: "avatar"}));

xhr.upload.onprogress = (e) => {
  if (e.lengthComputable) {
    console.log(`上传中: ${e.loaded}/${e.total}`);
  }
};

xhr.onload = () => {
  if (xhr.status === 200) {
    console.log("上传成功", xhr.responseText);
  }
};

xhr.send(formData);

fetch 上传并设请求头?小心 Content-Type 冲突

fetch 看似更现代,但对 FormData 的处理更严格:一旦你手动设置了 Content-Type 头,浏览器就会拒绝发送请求(报 TypeError: Failed to execute 'fetch' on 'Window': Invalid value for Content-Type header)。这是因为 FormData 必须由浏览器自动生成带 boundaryContent-Type,你不能覆盖它。

  • 可以设 AuthorizationX-Request-ID 等非禁止头
  • 绝对不要手动 set Content-Type —— 让 fetch 自动推导
  • 如果后端要求特定 Content-Type(比如 application/json),那就不能用 FormData,得把文件转成 BlobArrayBuffer 再发,此时你才能完全控制头和 body
const formData = new FormData();
formData.append("file", fileInput.files[0]);

fetch("/upload", {
  method: "POST",
  headers: {
    "Authorization": "Bearer abc123",
    "X-Trace-ID": "req-789"
    // ❌ 不要加 "Content-Type": "multipart/form-data"
  },
  body: formData
})
.then(r => r.json())
.then(console.log);

后端接收时注意:XMLHttpRequestfetch 发的 multipart 没区别,但 CORS 头必须配全

无论用哪种前端方式,只要带了自定义请求头(如 Authorization),浏览器就会先发一个 OPTIONS 预检请求。后端必须返回正确的 CORS 响应头,否则请求直接被拦在浏览器层:

微购 社会化购物分享返利系统
微购 社会化购物分享返利系统

升级说明:1.头像上传部分浏览器没法选择bug2.后台增加会员登录次数,后台修改会员密码功能3.b2c广告后台可以控制4.商品详情页面显示b2c返利价格和淘宝返积分bug5.修复360安全检测检测出的 注册页面有跨站脚本攻击漏洞bug6.邀请好友链接地址bug7.后台自定义采集bug, 采集后商品分类的数量不变bug8.后台30天推广量 单位错误bug9.修复用户中心修改emali不起作用的b

下载

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

  • Access-Control-Allow-Origin 不能是通配符 *(当带认证头时)
  • 必须显式声明 Access-Control-Allow-Headers,包含你实际用的头名,如 Authorization, X-Client-Version
  • 如果需要 Cookie 或认证信息,前端 fetch 要加 credentials: "include",后端还得回 Access-Control-Allow-Credentials: true

漏掉任意一项,控制台就会显示 No 'Access-Control-Allow-Headers' header is present 或类似跨域错误——这时候前端代码再对也没用。

相关专题

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

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

412

2023.08.07

json是什么
json是什么

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

533

2023.08.23

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

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

310

2023.10.13

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

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

74

2025.09.10

html5动画制作有哪些制作方法
html5动画制作有哪些制作方法

html5动画制作方法有使用CSS3动画、使用JavaScript动画库、使用HTML5 Canvas等。想了解更多html5动画制作方法相关内容,可以阅读本专题下面的文章。

506

2023.10.23

HTML与HTML5的区别
HTML与HTML5的区别

HTML与HTML5的区别:1、html5支持矢量图形,html本身不支持;2、html5中可临时存储数据,html不行;3、html5新增了许多控件;4、html本身不支持音频和视频,html5支持;5、html无法处理不准确的语法,html5能够处理等等。想了解更多HTML与HTML5的相关内容,可以阅读本专题下面的文章。

427

2024.03.06

html5从入门到精通汇总
html5从入门到精通汇总

想系统掌握HTML5开发?本合集精选全网优质学习资源,涵盖免费教程、实战项目、视频课程与权威电子书,从基础语法到高级特性(Canvas、本地存储、响应式布局等)一应俱全,适合零基础小白到进阶开发者,助你高效入门并精通HTML5前端开发。

20

2025.12.30

html5新老标签汇总
html5新老标签汇总

HTML5在2026年持续优化网页语义化与交互体验,不仅引入了如<header>、<nav>、<article>、<section>、<aside>、<footer>等结构化标签,还新增了<video>、<audio>、<canvas>、<figure>、<time>、<mark>等增强多媒体与

15

2025.12.30

高德地图升级方法汇总
高德地图升级方法汇总

本专题整合了高德地图升级相关教程,阅读专题下面的文章了解更多详细内容。

72

2026.01.16

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
极致CMS零基础建站教学视频
极致CMS零基础建站教学视频

共62课时 | 5.4万人学习

如何进行WebSocket调试
如何进行WebSocket调试

共1课时 | 0.1万人学习

传智播客AJAX视频教程
传智播客AJAX视频教程

共31课时 | 6.1万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号