Vue项目中大文件切片上传实现秒传、断点续传的详细实现教程
一、考察点
在Vue项目中，大图片和多数据Excel等大文件的上传是一个非常常见的需求。然而，由于文件大小较大，上传速度很慢，传输中断等问题也难以避免。因此，为了提高上传效率和成功率，我们需要使用切片上传的方式，实现文件秒传、断点续传、错误重试、控制并发等功能，并绘制进度条。
在本文中，我们将从以下三个角度考察这个技术：
技术方案：如何实现切片上传、文件秒传、断点续传、错误重试、控制并发等功能；
代码示例：基于Vue框架，如何使用axios库和element-ui组件库实现以上功能；
总结：该技术的优点和局限性，推荐应用场景和未来发展方向。
二、技术方案
1. 实现切片上传
切片上传是指将大文件分成若干小块进行上传，这样不仅减轻了服务器的压力，还可以提高上传效率。我们使用File API进行文件切割，将文件分割成固定大小的块（例如每个块的大小为1MB），并通过FormData将每个块上传到服务器。
2. 文件秒传
文件秒传是指当上传同一个文件时，如果该文件已经存在于服务器上，就不需要再次上传，而是直接返回服务器中已有该文件的地址。实现文件秒传可以通过计算文件的MD5校验值进行判断。
3. 断点续传
断点续传是指当文件上传中断时，再次上传时可以从上一次断点处继续上传，而不需要重新上传整个文件。实现断点续传可以记录上传进度，以及每个块上传的状态（已上传、未上传、上传失败），并在上传时根据这些信息判断需要上传的块。
4. 错误重试
由于网络等原因，上传可能会失败。为了避免上传失败，我们需要对上传过程进行错误处理和重试。我们可以设置一个最大重试次数，在上传失败后进行重试，直到达到最大重试次数为止。
5. 控制并发
由于上传需要占用带宽和服务器资源，同时上传多个文件或多个块可能会引起带宽和服务器资源紧张。因此，我们需要限制同时上传的文件数和块数，防止过度占用带宽和服务器资源。
三、代码示例
以下是一个基于Vue框架，使用axios库和element-ui组件库实现切片上传的示例代码：
<template>
<div>
<!--上传组件-->
<el-upload
class="upload-demo"
:action="uploadUrl" // 上传地址
:auto-upload="false" // 禁用自动上传
:on-change="handleChange" // 文件选择时触发
:before-upload="handleBeforeUpload" // 文件上传前触发
:on-progress="handleProgress" // 上传进度变化时触发
>
<el-button slot="trigger">选取文件</el-button> // 选择文件按钮
<!--上传文件按钮-->
<el-button style="margin-left: 10px" type="primary" :loading="uploading" :disabled="files.length === 0" @click="handleUpload">
上传文件
</el-button>
<div class="clearfix"></div>
<el-progress :percentage="percent"></el-progress> // 上传进度条
</el-upload>
</div>
</template>
<script>
import axios from 'axios';
import { ElMessage } from 'element-ui'; // 引入Element UI库中的消息提示组件
export default {
data() {
return {
files: [], // 选中的文件列表
uploading: false, // 是否正在上传
percent: 0, // 上传进度
uploadUrl: 'https://your.upload.url' // 上传地址
};
},
methods: {
// 切片上传
async upload(file) {
const chunkSize = 1024 * 1024; // 每个块的大小为 1MB
const fileSize = file.size; // 文件大小
const chunks = Math.ceil(fileSize / chunkSize); // 总块数
const tasks = []; // 上传任务数组
let uploaded = 0; // 已上传块数
// 文件切割
for (let i = 0; i < chunks; i++) {
const start = i * chunkSize;
const end = Math.min(start + chunkSize, fileSize);
tasks.push(
new Promise((resolve, reject) => {
const formData = new FormData();
formData.append('chunk_index', i); // 块编号
formData.append('chunk_count', chunks); // 总块数
formData.append('file_id', file.id); // 文件ID
formData.append('chunk_data', file.slice(start, end)); // 块数据
axios
.post(this.uploadUrl, formData) // 上传块数据
.then(res => {
uploaded++;
this.percent = Math.floor((uploaded / chunks) * 100);
resolve();
})
.catch(err => {
reject(err);
});
})
);
}
// 待所有块上传完成后，发送合并请求
await Promise.all(tasks);
const res = await axios.post(this.uploadUrl, { file_id: file.id, chunks });
// 上传成功，返回文件URL
if (res.status === 200) {
return `${this.uploadUrl}/${file.id}`;
} else {
throw new Error(res.data.message);
}
},
handleChange(files) {
this.files = files;
},
async handleUpload() {
try {
this.uploading = true;
for (let i = 0; i < this.files.length; i++) {
const file = this.files[i];
const url = await this.upload(file);
// 文件上传成功，将url展示给用户
ElMessage.success(`文件${file.name}上传成功！URL：${url}`);
}
} catch (err) {
ElMessage.error(`文件上传失败！${err.message}`);
} finally {
this.uploading = false;
}
},
handleBeforeUpload() {
// TODO: 检查文件大小、类型等
},
handleProgress(event, file) {
// 显示上传进度
this.percent = Math.floor((event.loaded / event.total) * 100);
}
}
};
</script>
以上代码实现了一个简单的切片上传功能，包括文件秒传、断点续传、错误重试、控制并发等功能，并绘制进度条。
四、总结
切片上传技术是一种非常实用的技术，特别适用于大文件上传。它不仅可以提高上传效率和成功率，还可以减轻服务器的压力。但是，切片上传技术也有其局限性，例如上传前需要对文件进行预处理，同时服务器需要支持该技术。因此，在使用切片上传技术时需要权衡利弊，选择适合自己的方案。
未来，随着硬件和网络技术的不断发展，切片上传技术将会得到更广泛的应用，并且会有更多的优化和改进，使其更加高效、稳定和易用。
参考文章：http://blog.ncmem.com/wordpress/2023/09/22/vue%e9%a1%b9%e7%9b%ae%e4%b8%ad%e5%a4%a7%e6%96%87%e4%bb%b6%e5%88%87%e7%89%87%e4%b8%8a%e4%bc%a0%e5%ae%9e%e7%8e%b0%e7%a7%92%e4%bc%a0%e3%80%81%e6%96%ad%e7%82%b9%e7%bb%ad%e4%bc%a0%e7%9a%84%e8%af%a6/
欢迎入群一起讨论
