MultipartFile 是不是表示仅仅是一个分片?

阿维的博客日记2026-07-17 21:50

文章目录

不是。MultipartFile本身并不表示"文件分片"。

它准确表示的是：

multipart/form-data请求中的一个文件字段。

这里的Multipart是指一次HTTP请求可以包含多个表单部分，不是指把一个大文件切成多块。

普通上传

浏览器一次上传完整文件：

java 复制代码

@PostMapping("/upload")
public void upload(@RequestParam MultipartFile file) {
    // file代表整个文件
}

请求中可能包含：

text 复制代码

用户名字段
文件说明字段
完整文件字段

Spring把其中的完整文件字段封装成一个MultipartFile。

多文件上传

java 复制代码

@PostMapping("/upload")
public void upload(@RequestParam List<MultipartFile> files) {
}

此时通常是：

text 复制代码

files[0] = 完整文件A
files[1] = 完整文件B
files[2] = 完整文件C

每个MultipartFile仍然代表一个完整文件。

分片上传

只有前端主动把大文件切开时，MultipartFile才可能表示一个分片：

java 复制代码

@PostMapping("/upload-chunk")
public void uploadChunk(
    @RequestParam MultipartFile chunk,
    @RequestParam Integer chunkIndex,
    @RequestParam Integer totalChunks
) {
}

流程是：

text 复制代码

原始大文件
    ↓ 前端主动切分
分片0、分片1、分片2
    ↓ 分别上传
每个分片封装成一个MultipartFile
    ↓
服务器保存并最终合并

Spring并不知道收到的是完整文件还是分片，它只知道：

HTTP请求中有一个文件字段，我将其封装成MultipartFile。

因此，是否为分片由你的上传业务决定：

上传方式	一个`MultipartFile`代表什么
普通单文件上传	一个完整文件
多文件上传	多个完整文件中的一个
前端分片上传	原始文件的一个分片

最关键的一句话是：

MultipartFile表示HTTP表单中的一个文件部分；它是不是"文件分片"，取决于客户端上传给它的内容。