0

0

JS如何实现文件分片上传

煙雲

煙雲

发布时间:2025-08-25 13:21:01

|

1024人浏览过

|

来源于php中文网

原创

文件分片上传通过将大文件分割为多个小块并行上传,提升速度与稳定性。1. 核心思路是将文件切片上传,服务器接收后合并,避免网络波动导致整体重传;2. 客户端实现中,使用file api切割文件,通过formdata发送每个分片及元信息(如分片编号、总数、文件名),并用fetch或xmlhttprequest上传;3. 服务器端需保存分片,检查是否全部到达后再合并,node.js示例使用multer存储分片并触发合并逻辑;4. 上传中断可通过客户端重试失败分片、服务端校验已传分片实现断点续传;5. 分片大小建议2mb至5mb,权衡请求开销与重传成本,依据网络、文件大小和服务器性能调整;6. 上传进度可通过xmlhttprequest的upload.onprogress事件实时计算并更新;7. 安全性需校验文件类型、权限控制接口访问,并使用https加密传输。该方案完整支持高效、稳定、可恢复的大文件上传,最终在所有分片成功上传后完成合并,确保用户体验与数据安全。

JS如何实现文件分片上传

将大文件分割成小块,并行上传,提高上传速度和稳定性。

解决方案

文件分片上传的核心思路是将一个大文件分割成多个小文件(即分片),然后并发地将这些分片上传到服务器。服务器接收到所有分片后,再将它们合并成完整的文件。这种方式可以有效利用带宽,提高上传速度,并且在网络环境不稳定时,可以只重传失败的分片,而不是整个文件。

以下是一个简化的JS实现文件分片上传的示例:




  文件分片上传


  
  
  

这个例子中,我们首先获取用户选择的文件,然后计算需要分割成多少个分片。接着,我们循环地将每个分片上传到服务器。 每次上传都将分片数据、分片编号、总分片数和文件名一起发送到服务器。 服务器端需要能够接收这些数据,并将分片保存起来,最后在所有分片都上传完成后,将它们合并成完整的文件。

服务器端 (Node.js 示例)

const express = require('express');
const multer = require('multer');
const fs = require('fs');
const path = require('path');

const app = express();
const uploadDir = path.join(__dirname, 'uploads');

if (!fs.existsSync(uploadDir)) {
  fs.mkdirSync(uploadDir);
}

const storage = multer.diskStorage({
  destination: (req, file, cb) => {
    cb(null, uploadDir);
  },
  filename: (req, file, cb) => {
    const filename = req.body.filename; // 从请求体中获取文件名
    const chunkNumber = req.body.chunkNumber;
    cb(null, `${filename}_${chunkNumber}`); // 分片命名
  }
});

const upload = multer({ storage: storage });

app.use(express.static('public')); // 静态文件服务,用于提供 HTML

app.post('/upload', upload.single('file'), (req, res) => {
  console.log('分片上传成功', req.file.filename);
  res.json({ message: '分片上传成功' });

  // 检查是否所有分片都已上传,如果是,则合并文件
  const filename = req.body.filename;
  const totalChunks = parseInt(req.body.totalChunks);
  const chunkFiles = [];

  for (let i = 1; i <= totalChunks; i++) {
    chunkFiles.push(path.join(uploadDir, `${filename}_${i}`));
  }

  const allChunksExist = chunkFiles.every(file => fs.existsSync(file));

  if (allChunksExist) {
    console.log('所有分片已上传,开始合并');
    const finalFile = path.join(uploadDir, filename);
    const writeStream = fs.createWriteStream(finalFile);

    chunkFiles.forEach(chunkFile => {
      const readStream = fs.createReadStream(chunkFile);
      readStream.pipe(writeStream, { end: false }); // 不要关闭 writeStream
      readStream.on('end', () => {
        fs.unlinkSync(chunkFile); // 删除分片
      });
    });

    writeStream.on('finish', () => {
      console.log('文件合并完成');
    });
  }
});

app.listen(3000, () => {
  console.log('Server listening on port 3000');
});

这个Node.js示例使用了

express
multer
库来处理文件上传。
multer
中间件负责接收上传的文件,并将其保存到服务器的
uploads
目录下。 每次上传成功后,服务器会检查是否所有分片都已上传,如果是,则将它们合并成完整的文件。

如何处理上传中断和重试?

webuploader-js实现多图片批量上传插件
webuploader-js实现多图片批量上传插件

webuploader-js实现多图片批量上传插件

下载

上传中断是分片上传中常见的问题。 为了解决这个问题,可以在客户端和服务器端都实现重试机制。

  • 客户端重试: 如果某个分片上传失败,客户端可以尝试重新上传该分片。 可以设置最大重试次数,避免无限循环。
  • 服务器端校验: 服务器端可以记录已接收的分片,并在接收到新的分片时,检查该分片是否已经存在。 如果已经存在,可以跳过该分片的上传。 这样可以避免重复上传。

如何优化分片大小的选择?

分片大小的选择会影响上传速度和稳定性。 分片太小,会导致过多的HTTP请求,增加网络开销。 分片太大,如果上传失败,则需要重传整个分片,浪费带宽。

  • 网络环境: 在网络环境较好的情况下,可以选择较大的分片大小。 在网络环境较差的情况下,可以选择较小的分片大小。
  • 文件大小: 对于较小的文件,可以选择较大的分片大小。 对于较大的文件,可以选择较小的分片大小。
  • 服务器性能: 服务器性能也会影响分片大小的选择。 如果服务器性能较好,可以选择较大的分片大小。 如果服务器性能较差,可以选择较小的分片大小。

一个常见的做法是使用 2MB 到 5MB 的分片大小。

如何处理上传进度显示?

显示上传进度可以提高用户体验。 可以使用

XMLHttpRequest
对象的
upload.onprogress
事件来监听上传进度。

const xhr = new XMLHttpRequest();
xhr.upload.onprogress = (event) => {
  if (event.lengthComputable) {
    const percentComplete = (event.loaded / event.total) * 100;
    console.log(`上传进度: ${percentComplete}%`);
    // 更新进度条
  }
};

xhr.open('POST', uploadUrl);
xhr.send(formData);

安全性考虑

分片上传也需要考虑安全性问题。

  • 防止恶意文件: 服务器端需要对上传的文件进行校验,防止恶意文件上传。
  • 防止未授权访问: 需要对上传接口进行权限控制,防止未授权用户上传文件。
  • 数据加密: 可以使用HTTPS协议对上传的数据进行加密,防止数据泄露。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
什么是中间件
什么是中间件

中间件是一种软件组件,充当不兼容组件之间的桥梁,提供额外服务,例如集成异构系统、提供常用服务、提高应用程序性能,以及简化应用程序开发。想了解更多中间件的相关内容,可以阅读本专题下面的文章。

178

2024.05.11

Golang 中间件开发与微服务架构
Golang 中间件开发与微服务架构

本专题系统讲解 Golang 在微服务架构中的中间件开发,包括日志处理、限流与熔断、认证与授权、服务监控、API 网关设计等常见中间件功能的实现。通过实战项目,帮助开发者理解如何使用 Go 编写高效、可扩展的中间件组件,并在微服务环境中进行灵活部署与管理。

217

2025.12.18

硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

1159

2023.10.19

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

215

2025.10.17

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2065

2025.12.29

java接口相关教程
java接口相关教程

本专题整合了java接口相关内容,阅读专题下面的文章了解更多详细内容。

23

2026.01.19

go语言 数组和切片
go语言 数组和切片

本专题整合了go语言数组和切片的区别与含义,阅读专题下面的文章了解更多详细内容。

46

2025.09.03

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

515

2023.06.20

2026赚钱平台入口大全
2026赚钱平台入口大全

2026年最新赚钱平台入口汇总,涵盖任务众包、内容创作、电商运营、技能变现等多类正规渠道,助你轻松开启副业增收之路。阅读专题下面的文章了解更多详细内容。

54

2026.01.31

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
【web前端】Node.js快速入门
【web前端】Node.js快速入门

共16课时 | 2万人学习

开源物联网开发实例
开源物联网开发实例

共6课时 | 0.4万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号