登录
首页 >  文章 >  前端

JavaScript实现大文件分片上传_javascript实战

时间:2025-11-20 15:09:31 273浏览 收藏

golang学习网今天将给大家带来《JavaScript实现大文件分片上传_javascript实战》,感兴趣的朋友请继续看下去吧!以下内容将会涉及到等等知识点,如果你是正在学习文章或者已经是大佬级别了,都非常欢迎也希望大家都能给我建议评论哈~希望能帮助到大家!

分片上传通过将大文件切割为小块依次传输,解决超时与内存问题。前端使用File API切片并用FormData逐个发送,服务端暂存后合并。需协同设计协议字段,并可扩展断点续传、进度显示、错误重试等机制以提升稳定性与用户体验。

JavaScript实现大文件分片上传_javascript实战

大文件上传是前端开发中常见的需求,直接上传几百MB甚至几个GB的文件容易导致请求超时、内存溢出或网络中断。为了解决这个问题,JavaScript可以通过分片上传的方式将大文件切分成多个小块,逐个上传,提升稳定性和用户体验。

一、文件分片的基本原理

分片上传的核心思想是将一个大文件按照固定大小(如5MB)切割成多个Blob对象,然后依次或并发上传这些片段。服务端接收后按序合并,最终还原为原始文件。

实现的关键步骤包括:

  • 使用File API读取用户选择的文件
  • 通过slice()方法对文件进行切片
  • 构造FormData发送每个分片到服务器
  • 服务端记录已上传分片并支持断点续传(可选)
  • 所有分片上传完成后通知服务端合并

二、前端实现分片上传逻辑

以下是一个简洁但完整的JavaScript实现示例:

function uploadFileInChunks(file, chunkSize = 5 * 1024 * 1024) {
  const chunks = [];
  let start = 0;
<p>// 切割文件
while (start < file.size) {
const end = Math.min(start + chunkSize, file.size);
chunks.push(file.slice(start, end));
start = end;
}</p><p>// 上传每个分片
chunks.forEach((chunk, index) => {
const formData = new FormData();
formData.append('file', chunk);
formData.append('filename', file.name);
formData.append('totalChunks', chunks.length);
formData.append('chunkIndex', index);</p><pre class="brush:php;toolbar:false"><code>fetch('/upload', {
  method: 'POST',
  body: formData
})
.then(response =&gt; response.json())
.then(data =&gt; {
  if (data.success) {
    console.log(`分片 ${index} 上传成功`);
    // 可更新进度条
  }
})
.catch(err =&gt; {
  console.error(`分片 ${index} 上传失败`, err);
});</code>

}); }

HTML部分只需一个input元素:

&lt;input type=&quot;file&quot; onchange=&quot;uploadFileInChunks(this.files[0])&quot; /&gt;

三、服务端配合处理(Node.js示例)

前端上传的是分片,服务端需要暂存并最终合并。以Express为例:

const express = require('express');
const multer = require('multer');
const fs = require('fs');
const path = require('path');
<p>const app = express();
const upload = multer({ dest: 'uploads/' }); // 临时存储路径</p><p>// 接收分片
app.post('/upload', upload.single('file'), (req, res) => {
const { filename, chunkIndex, totalChunks } = req.body;
const chunkPath = path.join('chunks', <code>${filename}.part${chunkIndex}</code>);</p><p>fs.renameSync(req.file.path, chunkPath);</p><p>// 检查是否全部上传完毕
let uploaded = 0;
for (let i = 0; i < totalChunks; i++) {
if (fs.existsSync(path.join('chunks', <code>${filename}.part${i}</code>))) {
uploaded++;
}
}</p><p>if (uploaded == totalChunks) {
mergeChunks(filename, totalChunks);
return res.json({ success: true, message: '上传完成,已合并' });
}</p><p>res.json({ success: true });
});</p><p>function mergeChunks(filename, totalChunks) {
const writeStream = fs.createWriteStream(path.join('uploads', filename));
for (let i = 0; i < totalChunks; i++) {
const chunkPath = path.join('chunks', <code>${filename}.part${i}</code>);
const data = fs.readFileSync(chunkPath);
writeStream.write(data);
fs.unlinkSync(chunkPath); // 删除临时分片
}
writeStream.end();
}
</p>

四、优化与增强功能

实际项目中还需考虑更多细节:

  • 上传进度显示:通过监听fetch的upload事件计算已上传分片比例
  • 断点续传:服务端记录已上传的分片,页面刷新后先查询已完成的部分
  • 错误重试:某一分片失败时自动重试几次
  • 并发控制:避免同时上传太多分片压垮浏览器或网络
  • MD5校验:前端计算文件哈希,防止重复上传相同文件

基本上就这些。分片上传并不复杂,关键是前后端协同设计好协议字段(如文件名、分片索引、总数等),再逐步加入健壮性机制即可满足生产环境需求。

好了,本文到此结束,带大家了解了《JavaScript实现大文件分片上传_javascript实战》,希望本文对你有所帮助!关注golang学习网公众号,给大家分享更多文章知识!

相关阅读
更多>
最新阅读
更多>
课程推荐
更多>