0

0

HTML5怎样用Ajax无刷新上传_HTML5Ajax无刷新上传技巧【精要】

雪夜

雪夜

发布时间:2026-01-19 16:23:02

|

860人浏览过

|

来源于php中文网

原创

不用。HTML表单enctype仅对直接提交生效,Ajax上传绕过该机制;关键要用FormData构造请求体,由浏览器自动设置含boundary的Content-Type,手动设置会破坏multipart格式。

html5怎样用ajax无刷新上传_html5ajax无刷新上传技巧【精要】

XMLHttpRequest 上传文件时必须设置 enctype 吗?

不用。HTML 表单的 enctype 属性只在表单**直接提交**(非 Ajax)时生效;Ajax 上传完全绕过表单提交机制,所以 enctype="multipart/form-data"XMLHttpRequest 无实际作用——它甚至会被忽略。

真正关键的是:必须用 FormData 构造请求体,并让浏览器自动设置正确的 Content-Type(含 boundary)。手动设 Content-Type 反而会破坏 multipart 格式。

  • ✅ 正确做法:
    const fd = new FormData();
    fd.append('file', input.files[0]);
    fd.append('name', 'report.pdf');

    const xhr = new XMLHttpRequest();
    xhr.open('POST', '/upload');
    // 不要 setRequestHeader('Content-Type')!
    xhr.send(fd);
  • ❌ 常见错误:手动设置 Content-Type: multipart/form-data,导致服务端收不到文件字段
  • ⚠️ 注意:FormData 不能通过 JSON.stringify() 转换,也不支持直接赋值给 xhr.send() 的字符串参数

fetch 上传文件时如何监听进度?

fetch 本身不提供上传进度回调,但可通过 ReadableStream + TransformStream 手动拆包并计数,或更稳妥地回退到 XMLHttpRequest ——尤其在需兼容 Safari 15.4 之前版本时。

若坚持用 fetch,推荐封装一个带进度的包装函数:

MaxAI
MaxAI

MaxAI.me是一款功能强大的浏览器AI插件,集成了多种AI模型。

下载

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

  • 监听方式依赖 XMLHttpRequest.upload.onprogressfetch 没有等价 API
  • 可借助 formdata-polyfill 或原生 FormData + XMLHttpRequest 组合实现稳定进度条
  • 示例中不要用 fetch(...).then(r => r.json()) 直接处理响应,因为上传失败时可能返回 HTML 错误页而非 JSON,需先检查 response.ok

服务端接收不到 file 字段?排查这三处

前端看似正常发送,但后端 req.files$_FILES 为空,大概率不是跨域问题,而是字段名/结构不匹配。

  • 确认 FormData.append() 的第一个参数(字段名)和服务端预期一致,例如 Node.js multer 默认期待 file,PHP $_FILES['file']
  • 避免重复 append 同名字段却不加索引,如 fd.append('file', f1); fd.append('file', f2),某些后端只取第一个
  • 如果上传多个文件,建议用数组式命名:fd.append('files[]', f1); fd.append('files[]', f2),再配合后端解析逻辑
  • Chrome DevTools 的 Network → Payload 标签页里,点开请求可查看真实 multipart body,确认 boundary 是否存在、字段是否被包裹

移动端 iOS Safari 上传大文件卡住?

iOS Safari 对 XMLHttpRequest 上传有隐式限制:当文件 > ~50MB 且未设置超时或未监听 loadstart / progress 时,可能静默失败或长时间 pending。

  • 务必设置 xhr.timeout = 300000(5 分钟),并监听 timeout 事件给出提示
  • 即使不显示进度条,也建议注册 xhr.upload.onloadstart,否则某些 iOS 版本不会真正触发上传
  • 避免在 input[type="file"] 上直接用 click() 模拟唤起——iOS 需用户真实点击,否则 files 为 null
  • 上传前可用 file.size 做客户端校验,比如提示“文件不能超过 100MB”,比服务端报错体验更好
实际项目里最常被忽略的,是服务端对 multipart 解析器的字段大小限制(如 Express multerlimits.fileSize、Nginx 的 client_max_body_size),前端一切正常,但文件一到网关就被截断——得前后端一起看日志。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2678

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1659

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1515

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

952

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1419

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1235

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1488

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1306

2023.11.13

PHP WebSocket 实时通信开发
PHP WebSocket 实时通信开发

本专题系统讲解 PHP 在实时通信与长连接场景中的应用实践,涵盖 WebSocket 协议原理、服务端连接管理、消息推送机制、心跳检测、断线重连以及与前端的实时交互实现。通过聊天系统、实时通知等案例,帮助开发者掌握 使用 PHP 构建实时通信与推送服务的完整开发流程,适用于即时消息与高互动性应用场景。

11

2026.01.19

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
极致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号