文件分片上传记录

文件分片上传记录用于查看和管理大文件分片上传的记录信息，即页面上的前端上传按钮，这里是对分片上传进度和记录的查询。

快速访问

在文件分片上传记录页面，您可以快速访问在线系统。

在线访问入口：打开文件分片上传记录

业务说明

什么是分片上传？

分片上传是将大文件切分成多个小块（分片），逐个上传到存储服务器，最后再合并成完整文件的上传方式。这种方式特别适合大文件上传场景。

为什么需要分片上传？

问题	传统上传	分片上传
网络中断	需要重新上传整个文件	只需续传未完成的分片
上传速度	大文件上传慢	并行上传多个分片，速度快
稳定性	容易超时失败	单个分片小，成功率高
进度显示	难以准确显示	可精确显示每个分片进度

数据流向

Mermaid Diagram Code:

graph TB
    A[用户选择文件] --> B[计算文件MD5]
    B --> C[文件切分为分片]
    C --> D[初始化上传任务]
    D --> E[获取分片上传地址]
    E --> F[逐个上传分片]
    F --> G{上传中断?}
    G -->|是| H[记录已上传分片]
    H --> I[下次继续上传]
    I --> F
    G -->|否| J[所有分片上传完成]
    J --> K[合并分片为完整文件]
    K --> L[文件上传成功]

断点续传原理

当上传过程中断（如网络故障、浏览器关闭），系统会记录已上传的分片。下次上传时：

系统识别文件MD5，找到对应的上传记录
查询已上传的分片列表
只上传未完成的分片
所有分片完成后合并文件

操作指南

以下是文件分片上传记录的具体操作指南。

查看上传记录

在文件管理菜单下，选择"文件分片上传记录"，可以查看所有分片上传记录。

分片上传记录列表

记录信息包括：

配置名称：使用的存储器
文件名：原始文件名
状态：上传中/已完成/失败
创建时间：任务创建时间

搜索记录

在文件分片上传记录中，支持按以下条件搜索：

文件名称
上传状态
创建时间范围

删除记录

在文件分片上传记录中，删除上传记录的操作如下：

选择要删除的记录
点击"删除"按钮
确认删除操作

删除记录

注意

删除记录会清除上传进度
未完成的上传将无法续传
已完成的文件不受影响

上传状态说明

文件分片上传的任务状态包括：

状态	说明	用户操作
已生成任务	上传任务已创建，等待开始上传	可开始上传
上传中	文件正在上传	等待完成或暂停
上传完成	所有分片上传完成，文件合并成功	无需操作
上传失败	上传过程中出现错误	可重新上传

分片上传流程

完整上传流程

选择文件：用户选择要上传的文件
计算MD5：系统计算文件MD5值（用于唯一标识文件）
文件切分：将文件按5MB大小切分为多个分片
初始化任务：创建上传任务，获取任务ID
获取上传地址：获取每个分片的预签名上传地址
上传分片：逐个上传分片到存储器
合并文件：所有分片上传完成后，合并为完整文件
完成：文件上传成功，记录到文件列表

断点续传流程

识别文件：通过MD5值识别是否有未完成的上传
查询进度：获取已上传的分片列表
续传分片：只上传未完成的分片
合并文件：完成后合并

关联模块

分片上传功能在文件列表中上传大文件时自动启用
在文件分类管理中上传大型视频或APK时也会使用分片上传
上传配置在文件配置中设置

字段说明

以下是文件分片上传记录中各字段的详细说明。

字段名称	说明	业务用途
配置名称	存储配置的名称	知道文件存储位置
上传任务ID	分片上传的任务标识	系统内部使用
文件 key	文件的唯一键	基于MD5生成，用于断点续传
原文件名	文件的原始名称	识别文件
状态	上传任务状态	了解上传进度
创建时间	任务创建时间	追溯上传记录

注意事项

在进行文件分片上传时，请注意以下事项：

大文件（>10MB）建议使用前端分片上传
分片大小默认为5MB
上传中断后可继续上传，无需重新开始
相同MD5的文件可实现秒传
网络不稳定时建议使用分片上传
未完成的上传记录会占用临时存储空间，建议定期清理

快速访问​

业务说明​

什么是分片上传？​

为什么需要分片上传？​

数据流向​

断点续传原理​

操作指南​

查看上传记录​

搜索记录​

删除记录​

上传状态说明​

分片上传流程​

完整上传流程​

断点续传流程​

字段说明​

注意事项​

快速访问

业务说明

什么是分片上传？

为什么需要分片上传？

数据流向

断点续传原理

操作指南

查看上传记录

搜索记录

删除记录

上传状态说明

分片上传流程

完整上传流程

断点续传流程

字段说明

注意事项