0

0

HTML5FormData上传大文件_HTML5分片上传断点续传实现说明【介绍】

雪夜

雪夜

发布时间:2026-02-25 20:18:02

|

636人浏览过

|

来源于php中文网

原创

formdata传大文件需手动分片上传,用file.slice()切2–5mb/片,每片带chunkindex、totalchunks、uploadid,服务端须支持任意顺序接收、幂等写入、断点查询及校验合并。

html5formdata上传大文件_html5分片上传断点续传实现说明【介绍】

FormData 传大文件会卡死或失败,因为没分片

浏览器原生 FormData 不处理分片,直接塞进内存上传,超 100MB 就容易触发内存警告、请求超时或 Network Error。服务端也可能拒绝未分片的巨量 payload。

真正能落地的做法是:手动切片 + 每片单独发 FormData 请求,靠唯一 uploadId 关联同一文件。

  • File.prototype.slice()(非 ArrayBuffer.slice)切,兼容性好,返回新 Blob
  • 每片加字段:chunkIndextotalChunksuploadId(前端生成 crypto.randomUUID() 或时间戳+随机数)
  • 不要等所有片发完再合并——服务端应支持「任意顺序接收」,靠 uploadId + chunkIndex 写临时文件

断点续传必须依赖服务端校验,前端只管重试逻辑

前端无法知道某片是否真被服务端落盘成功,只看 HTTP 状态码不保险(比如 Nginx 缓存了 200 但后端写失败)。断点能力本质在服务端是否提供 /upload/status?uploadId=xxx 接口。

  • 上传前先 GET /upload/status?uploadId=xxx,返回已上传的 chunkIndex 列表
  • 跳过已存在的片,只发缺失的;注意服务端需对每个 chunkIndex 做幂等写入(如先检查文件是否存在)
  • 别用 XMLHttpRequest.upload.onprogress 估算进度——它反映的是浏览器发出数据的速度,不是服务端接收完成时间

Chrome/Firefox 对单个 FormData 的 Blob 大小没硬限制,但 V8 内存会爆

FormData.append('file', file.slice(0, 5 * 1024 * 1024)) 这种操作本身不会报错,但若切片太大(比如 50MB/片),JS 引擎在构造 FormData 时可能把整个 Blob 加载进内存,触发 Chrome 的 RangeError: Maximum call stack size exceeded 或直接崩溃。

Bardeen AI
Bardeen AI

使用AI自动执行人工任务

下载

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

  • 安全切片大小建议:2–5MB/片(实测 Firefox 对 10MB/片开始明显卡顿)
  • file.slice(start, end) 而不是读成 ArrayBuffer 再转 Blob,避免双份内存占用
  • 上传中保持对 File 对象的弱引用即可,不用 URL.createObjectURL()——那玩意不释放会吃内存

服务端没实现分片合并,前端再努力也没用

很多前端同学花半天写分片逻辑,结果发现服务端收完所有片就扔了,或者合并时顺序错乱、校验缺失,最终文件损坏。这是最常被忽略的协同点。

  • 确认服务端是否支持按 uploadId 扫描临时目录、按 chunkIndex 排序拼接、最后做 md5sha256 校验
  • 要求服务端返回明确错误:比如 {"code": 4001, "msg": "chunk 5 missing"},而不是笼统的 500
  • 前端重试最多 3 次,第 4 次该报错就报错,别无脑循环——可能是服务端根本没监听那个 uploadId

分片和断点续传不是前端单方面能闭环的事,服务端接口设计决定了 80% 的成败。别在没对齐 API 合约前写一堆切片工具函数。

相关文章

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

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

下载

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

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

240

2023.07.27

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

519

2023.08.04

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

587

2023.08.04

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

243

2024.02.23

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

585

2024.07.09

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

3606

2024.08.07

nginx部署php项目教程汇总
nginx部署php项目教程汇总

本专题整合了nginx部署php项目教程汇总,阅读专题下面的文章了解更多详细内容。

51

2026.01.13

nginx配置文件详细教程
nginx配置文件详细教程

本专题整合了nginx配置文件相关教程详细汇总,阅读专题下面的文章了解更多详细内容。

67

2026.01.13

batoto漫画官网入口与网页版访问指南
batoto漫画官网入口与网页版访问指南

本专题系统整理batoto漫画官方网站最新可用入口,涵盖最新官网地址、网页版登录页面及防走失访问方式说明,帮助用户快速找到batoto漫画官方平台,稳定在线阅读各类漫画内容。

127

2026.02.25

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.4万人学习

AngularJS教程
AngularJS教程

共24课时 | 3.8万人学习

CSS教程
CSS教程

共754课时 | 36.1万人学习

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

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