分片上传通过将大文件切块实现高效稳定传输。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):
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. 优化与注意事项
确保稳定性和性能,还需考虑以下几点:
- 使用唯一文件标识(可基于文件名+大小+哈希生成)防止冲突
- 限制单个文件最大尺寸,防止恶意上传
- 设置合理的超时和重试机制,网络不佳时自动重传失败分片
- 前端显示上传进度:已上传字节数 / 总字节数
- 服务端定期清理未完成的临时文件,避免磁盘占满
基本上就这些。分片上传不复杂但容易忽略细节,关键是前后端协同好分片管理与状态同步。










