0

0

HTML5如何实现分片上传_HTML5分片上传实现逻辑【核心】

看不見的法師

看不見的法師

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

|

639人浏览过

|

来源于php中文网

原创

分片上传核心是利用File.slice切片并控制并发:每片5MB,限3路并发,带唯一标识与超时;fetch/XHR选型需权衡进度监听与中止可靠性;服务端须暂存、校验、合并分片并处理续传。

html5如何实现分片上传_html5分片上传实现逻辑【核心】

分片上传的核心是 File.prototype.slice 和并发控制

浏览器端无法直接把一个大文件“拆开传”,必须靠 JavaScript 主动切片。关键不是 HTML5 本身支持分片,而是它提供了 File 对象和 Blob.prototype.slice 方法,让你能按字节范围提取子块。实际上传时,每一片都是独立的 FormData 请求,服务端需配合做合并与校验。

  • file.slice(start, end) 返回新 Blob,注意参数是字节偏移量(不是数组下标),且 end 不包含在内
  • 推荐每片大小设为 1024 * 1024 * 5(5MB),太大易超时,太小则 HTTP 开销占比高
  • 不能直接对 input[type="file"].files[0] 调用 .slice() 后立刻上传——要等 FileReaderfetch 拿到二进制内容再发,否则会传空

如何避免并发请求压垮浏览器或服务端

无节制并发(比如同时发 100 个 fetch)会导致连接池耗尽、内存暴涨、服务端拒绝响应。必须限制并发数,并确保失败后可重试。

  • Promise.allSettled + 队列控制:每次只允许最多 3 个请求在飞
  • 每个分片请求需带唯一标识,如 chunkIndextotalChunksfileHash(可选),方便服务端去重和排序
  • 上传失败的分片应记录索引,后续只重传失败项,不要整个重来
  • 务必设置 timeout(例如 abortController.timeout = 60_000),防止挂起请求阻塞队列

XMLHttpRequestfetch 在分片上传中的实际差异

两者都能用,但行为细节影响稳定性。尤其在中断续传、进度监听、错误捕获上差别明显。

  • fetch 默认不支持上传进度,必须用 ReadableStream + TransformStream 手动包装 Blob 才能监听,复杂度高;而 XMLHttpRequest.upload.onprogress 开箱即用
  • XMLHttpRequestabort() 更可靠,fetchAbortController 对已发出请求的终止效果依赖浏览器实现,部分旧版可能无效
  • 如果服务端要求带自定义 header(如 X-Upload-Chunk-Index),fetch 允许直接写;XMLHttpRequest 需确认服务端是否允许该 header(CORS 预检可能失败)

服务端必须处理的三个关键逻辑点

前端只是“发得出去”,真正决定分片上传成败的是服务端能否正确识别、暂存、合并、清理。

ImgGood
ImgGood

免费在线AI照片编辑器

下载

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

  • 收到分片后,不能直接写入最终文件,应以 {fileId}_{chunkIndex} 命名暂存到临时目录(如 /tmp/uploads/abc123_0
  • 合并前必须校验所有分片是否齐全(chunkIndex 是否连续、总数是否等于 totalChunks),并建议对每个分片算 md5sha256 与前端传来的比对
  • 合并完成后立即删除所有分片文件;若合并失败,应保留分片至少 24 小时,供前端发起续传
const uploadChunk = async (blob, index, fileId, total) => {
  const formData = new FormData();
  formData.append('chunk', blob, `chunk_${index}`);
  formData.append('chunkIndex', index);
  formData.append('totalChunks', total);
  formData.append('fileId', fileId);
<p>const controller = new AbortController();
setTimeout(() => controller.abort(), 60_000);</p><p>const res = await fetch('/upload/chunk', {
method: 'POST',
body: formData,
signal: controller.signal
});</p><p>if (!res.ok) throw new Error(<code>Chunk ${index} failed: ${res.status}</code>);
};

分片上传真正的复杂点不在切片本身,而在断网、刷新、重复提交、服务端崩溃这些边界场景下的状态一致性。前端缓存 fileId 和已成功上传的 chunkIndex 列表,比追求“一次传完”更重要。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

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

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

550

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的相关内容,可以阅读本专题下面的文章。

472

2024.03.06

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

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

299

2025.12.30

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

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

230

2025.12.30

html5空格代码怎么写
html5空格代码怎么写

在HTML5中,空格不能直接通过键盘空格键实现,需使用特定代码。本合集详解常用空格写法:&nbsp;(不间断空格)、&ensp;(半个中文空格)、&emsp;(一个中文空格)及CSS的white-space属性等方法,帮助开发者精准控制页面排版,避免因空格失效导致布局错乱,适用于新手入门与实战参考。

107

2025.12.30

html5怎么做网站教程
html5怎么做网站教程

想从零开始学做网站?这份《HTML5怎么做网站教程》合集专为新手打造!涵盖HTML5基础语法、页面结构搭建、表单与多媒体嵌入、响应式布局及与CSS3/JavaScript协同开发等核心内容。无需编程基础,手把手教你用纯HTML5创建美观、兼容、移动端友好的现代网页。附实战案例+代码模板,快速上手,轻松迈出Web开发第一步!

165

2025.12.31

HTML5建模教程
HTML5建模教程

想快速掌握HTML5模板搭建?本合集汇集实用HTML5建模教程,从零基础入门到实战开发全覆盖!内容涵盖响应式布局、语义化标签、Canvas绘图、表单验证及移动端适配等核心技能,提供可直接复用的模板结构与代码示例。无需复杂配置,助你高效构建现代网页,轻松上手前端开发!

53

2025.12.31

html5怎么使用
html5怎么使用

想快速上手HTML5开发?本合集为你整理最实用的HTML5使用指南!涵盖HTML5基础语法、主流框架(如Bootstrap、Vue、React)集成方法,以及无需安装、直接在线编辑运行的平台推荐(如CodePen、JSFiddle)。无论你是新手还是进阶开发者,都能轻松掌握HTML5网页制作、响应式布局与交互功能开发,零配置开启高效前端编程之旅!

73

2025.12.31

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

49

2026.03.13

热门下载

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

精品课程

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

共58课时 | 6.1万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 3.5万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.6万人学习

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

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