文件上传功能实现_处理大文件分片上传-js教程-PHP中文网

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

幻影之瞳

发布： 2025-12-02 15:53:02

原创

418人浏览过

分片上传通过将大文件切块实现高效稳定传输。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插件

查看详情

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();
}

登录后复制