0

0

文件上传功能实现_处理大文件分片上传

幻影之瞳

幻影之瞳

发布时间:2025-12-02 15:53:02

|

453人浏览过

|

来源于php中文网

原创

分片上传通过将大文件切块实现高效稳定传输。1. 前端利用File API按5MB切片,生成唯一标识并携带元信息上传;2. 后端接收后存入临时目录,记录分片状态;3. 支持断点续传,前端跳过已传分片,服务端校验哈希并合并;4. 优化包括唯一标识、大小限制、重试机制、进度显示及临时文件清理,确保稳定性与性能。

文件上传功能实现_处理大文件分片上传

大文件上传在实际开发中经常遇到,直接上传容易因网络波动或超时失败。分片上传是一种高效、稳定的解决方案。核心思路是将大文件切分为多个小块,逐个上传,最后在服务端合并。

1. 前端实现文件分片

利用浏览器File API 将文件切分成固定大小的块(如 5MB),每个块作为独立请求发送。

关键步骤:

  • 监听文件选择事件,获取原始文件对象
  • 设定分片大小(如 5 * 1024 * 1024 字节
  • 使用 file.slice(start, end) 方法截取二进制片段
  • 为每个分片生成唯一标识(如文件名 + 分片序号)
  • 通过 FormData 添加分片数据和元信息(如 index、total、hash)
  • 并发上传多个分片,控制请求数避免阻塞

示例代码片段:

const chunkSize = 5 * 1024 * 1024;
for (let start = 0; start < file.size; start += chunkSize) {
  const end = Math.min(start + chunkSize, file.size);
  const chunk = file.slice(start, end);
  const formData = new FormData();
  formData.append('chunk', chunk);
  formData.append('index', start / chunkSize);
  formData.append('filename', file.name);
  // 发送请求
  uploadChunk(formData);
}

2. 后端接收与存储分片

服务端需接收每一个分片,并按唯一标识暂存,等待所有分片完成后再合并。

处理逻辑:

  • 解析上传请求中的文件名、分片索引、总片数等信息
  • 创建临时目录,以文件名或哈希值命名子目录存放分片
  • 将接收到的分片写入对应位置(如 chunk_0, chunk_1)
  • 记录当前已上传的分片列表,支持断点续传查询
  • 所有分片到达后触发合并操作

Node.js 示例(Express):

fcup.js大文件分片上传jquery插件
fcup.js大文件分片上传jquery插件

fcup.js大文件分片上传jquery插件

下载
app.post('/upload/chunk', (req, res) => {
  const { filename, index } = req.body;
  const chunkPath = path.join(TEMP_DIR, filename, `chunk_${index}`);
  fs.mkdirSync(path.dirname(chunkPath), { recursive: true });
  req.pipe(fs.createWriteStream(chunkPath));
  req.on('end', () => res.json({ success: true }));
});

3. 支持断点续传与合并

提升用户体验的关键功能:允许中断后继续上传未完成的部分。

实现方式:

  • 前端上传前先请求服务端获取已上传的分片列表
  • 跳过已成功上传的分片,只传缺失部分
  • 依赖文件内容哈希(如 md5)判断是否同一文件
  • 服务端检查分片数量是否等于 total,全部到位后执行合并
  • 合并完成后删除临时分片文件,返回最终文件访问路径

合并脚本示意:

function mergeChunks(filename, total) {
  const outPath = path.join(UPLOAD_DIR, filename);
  const writeStream = fs.createWriteStream(outPath);
  for (let i = 0; i < total; i++) {
    const chunkPath = path.join(TEMP_DIR, filename, `chunk_${i}`);
    const chunk = fs.readFileSync(chunkPath);
    writeStream.write(chunk);
    fs.unlinkSync(chunkPath); // 删除分片
  }
  writeStream.end();
}

4. 优化与注意事项

确保稳定性和性能,还需考虑以下几点:

  • 使用唯一文件标识(可基于文件名+大小+哈希生成)防止冲突
  • 限制单个文件最大尺寸,防止恶意上传
  • 设置合理的超时和重试机制,网络不佳时自动重传失败分片
  • 前端显示上传进度:已上传字节数 / 总字节数
  • 服务端定期清理未完成的临时文件,避免磁盘占满

基本上就这些。分片上传不复杂但容易忽略细节,关键是前后端协同好分片管理与状态同步。

相关专题

更多
go语言 数组和切片
go语言 数组和切片

本专题整合了go语言数组和切片的区别与含义,阅读专题下面的文章了解更多详细内容。

46

2025.09.03

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

510

2023.06.20

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

244

2023.07.28

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

258

2023.08.03

js是什么意思
js是什么意思

JS是JavaScript的缩写,它是一种广泛应用于网页开发的脚本语言。JavaScript是一种解释性的、基于对象和事件驱动的编程语言,通常用于为网页增加交互性和动态性。它可以在网页上实现复杂的功能和效果,如表单验证、页面元素操作、动画效果、数据交互等。

5283

2023.08.17

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

477

2023.09.01

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

208

2023.09.04

Js中concat和push的区别
Js中concat和push的区别

Js中concat和push的区别:1、concat用于将两个或多个数组合并成一个新数组,并返回这个新数组,而push用于向数组的末尾添加一个或多个元素,并返回修改后的数组的新长度;2、concat不会修改原始数组,是创建新的数组,而push会修改原数组,将新元素添加到原数组的末尾等等。本专题为大家提供concat和push相关的文章、下载、课程内容,供大家免费下载体验。

218

2023.09.14

PS使用蒙版相关教程
PS使用蒙版相关教程

本专题整合了ps使用蒙版相关教程,阅读专题下面的文章了解更多详细内容。

12

2026.01.19

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
【web前端】Node.js快速入门
【web前端】Node.js快速入门

共16课时 | 2万人学习

开源物联网开发实例
开源物联网开发实例

共6课时 | 0.4万人学习

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

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