大文件上传的终极方案:分片上传与断点续传实战指南
🧑🏫 作者:全栈老李
📅 更新时间:2025 年 5 月
🧑💻 适合人群:前端初学者、进阶开发者
🚀 版权:本文由全栈老李原创,转载请注明出处。
作为前端工程师,你一定遇到过这样的场景:用户需要上传一个5GB的设计文件,结果上传到90%时网络断了,用户只能骂骂咧咧地重新开始...(别问我怎么知道的,说多了都是泪)今天全栈老李就带你彻底解决这个痛点!
为什么需要分片上传?
传统文件上传就像把一头大象塞进冰箱——要么成功要么失败。而分片上传则是把大象切成小块,一块一块往里放。即使中途断电,也能知道哪些块已经放好了,下次接着放剩下的。
分片上传的核心优势:
- 突破单次请求大小限制(比如nginx默认1MB)
- 网络中断后可以续传而非重传
- 多线程并行上传提升速度
- 服务端可以做更灵活的处理
分片上传实现原理
想象你在玩拼图游戏:
- 把大图拆成小碎片(分片)
- 给每个碎片编号(chunk序号)
- 记录哪些碎片已经拼好(已上传分片)
- 最后把所有碎片拼成原图(合并分片)
// 文件分片函数 - 全栈老李出品
function createFileChunks(file, chunkSize = 5 * 1024 * 1024) {
const chunks = []
let cur = 0
while (cur < file.size) {
chunks.push({
chunk: file.slice(cur, cur + chunkSize),
filename: `${
file.name}-${
chunks.length}`
})
cur += chunkSize
}
return chunks
}
断点续传的魔法
断点续传就像游戏存档功能:
- 上传前先问服务器:"老哥,这个文件传过没?"
- 服务器返回:"传过3片了,从第4片开始吧"
- 客户端接着上次的位置继续传
实现关键点:
- 文件唯一标识(可以用文件内容hash)
- 分片进度存储(本地或服务端)
- 分片校验机制(确保上传完整性)
// 检查已上传分片 - 全栈老李代码示例
async function checkUploadedChunks