分片上传通过将大文件切割为小块依次传输，解决超时与内存问题。前端使用File API切片并用FormData逐个发送，服务端暂存后合并。需协同设计协议字段，并可扩展断点续传、进度显示、错误重试等机制以提升稳定性与用户体验。
大文件上传是前端开发中常见的需求，直接上传几百MB甚至几个GB的文件容易导致请求超时、内存溢出或网络中断。为了解决这个问题，JavaScript可以通过分片上传的方式将大文件切分成多个小块，逐个上传，提升稳定性和用户体验。
一、文件分片的基本原理
分片上传的核心思想是将一个大文件按照固定大小（如5MB）切割成多个Blob对象，然后依次或并发上传这些片段。服务端接收后按序合并，最终还原为原始文件。
实现的关键步骤包括：
- 使用File API读取用户选择的文件
- 通过slice()方法对文件进行切片
- 构造FormData发送每个分片到服务器
- 服务端记录已上传分片并支持断点续传（可选）
- 所有分片上传完成后通知服务端合并
二、前端实现分片上传逻辑
以下是一个简洁但完整的JavaScript实现示例：
function uploadFileInChunks(file, chunkSize = 5 * 1024 * 1024) {
const chunks = [];
let start = 0;
// 切割文件
while (start < file.size) {
const end = Math.min(start + chunkSize, file.size);
chunks.push(file.slice(start, end));
start = end;
}
// 上传每个分片
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);
fetch('/upload', {
method: 'POST',
body: formData
})
.then(response => response.json())
.then(data => {
if (data.success) {
console.log(`分片 ${index} 上传成功`);
// 可更新进度条
}
})
.catch(err => {
console.error(`分片 ${index} 上传失败`, err);
});});
}
HTML部分只需一个input元素：
三、服务端配合处理（Node.js示例）
前端上传的是分片，服务端需要暂存并最终合并。以Express为例：
const express = require('express');
const multer = require('multer');
const fs = require('fs');
const path = require('path');
const app = express();
const upload = multer({ dest: 'uploads/' }); // 临时存储路径
// 接收分片
app.post('/upload', upload.single('file'), (req, res) => {
const { filename, chunkIndex, totalChunks } = req.body;
const chunkPath = path.join('chunks', ${filename}.part${chunkIndex});
fs.renameSync(req.file.path, chunkPath);
// 检查是否全部上传完毕
let uploaded = 0;
for (let i = 0; i < totalChunks; i++) {
if (fs.existsSync(path.join('chunks', ${filename}.part${i}))) {
uploaded++;
}
}
if (uploaded == totalChunks) {
merge
Chunks(filename, totalChunks);
return res.json({ success: true, message: '上传完成，已合并' });
}
res.json({ success: true });
});
function mergeChunks(filename, totalChunks) {
const writeStream = fs.createWriteStream(path.join('uploads', filename));
for (let i = 0; i < totalChunks; i++) {
const chunkPath = path.join('chunks', ${filename}.part${i});
const data = fs.readFileSync(chunkPath);
writeStream.write(data);
fs.unlinkSync(chunkPath); // 删除临时分片
}
writeStream.end();
}
四、优化与增强功能
实际项目中还需考虑更多细节：
Chunks(filename, totalChunks);
return res.json({ success: true, message: '上传完成，已合并' });
}- 上传进度显示：通过监听fetch的upload事件计算已上传分片比例
- 断点续传：服务端记录已上传的分片，页面刷新后先查询已完成的部分
- 错误重试：某一分片失败时自动重试几次
- 并发控制：避免同时上传太多分片压垮浏览器或网络
- MD5校验：前端计算文件哈希，防止重复上传相同文件
基本上就这些。分片上传并不复杂，关键是前后端协同设计好协议字段（如文件名、分片索引、总数等），再逐步加入健壮性机制即可满足生产环境需求。
