Spring Boot 中 MultipartFile 的单元测试实战

在 Spring Boot 项目中测试文件上传功能时，直接操作真实磁盘文件不仅效率低，还容易受环境差异影响。为了构建稳定、快速的单元测试，我们需要利用 MockMultipartFile 来模拟上传请求。

核心实现类对比

MultipartFile 接口主要有两个常用实现：

• MockMultipartFile：来自 spring-boot-starter-test，专为测试设计，轻量且可控。
• CommonsMultipartFile：基于 Commons FileUpload，通常用于集成测试或特定配置场景。

日常单元测试中，我们首选 MockMultipartFile。

构造 Mock 对象

创建 Mock 文件的核心在于正确传递参数。下面是一个标准的构造示例，注意文件流必须关闭或使用 try-with-resources 管理资源：

import org.springframework.mock.web.MockMultipartFile;
import java.io.File;
import java.io.FileInputStream;

File file = new File("/Users/coderec/Desktop/haha.jpg");
try (FileInputStream fis = new FileInputStream(file)) {
    MultipartFile mockFile = new MockMultipartFile(
        "file",                      // 表单字段名
        "haha.jpg",                  // 原始文件名
        "image/jpeg",                // MIME 类型
        fis                          // 输入流
    );
}

这里需要特别注意 contentType 参数。如果不确定具体类型，可以使用 APPLICATION_OCTET_STREAM，但最好根据实际业务设置，否则可能导致后端解析异常。

在测试中使用

有了 Mock 对象后，可以直接注入到 Service 层或配合 MockMvc 进行 Controller 层测试。以 Service 层为例，假设有一个处理上传的方法：

public void handleUpload(MultipartFile file)  IOException {
        ( + file.getOriginalFilename());
    file.transferTo(destFile);
}