如何将Multipart File映射到Cucumber Expression？

Cucumber默认没有内置MultipartFile的参数类型映射，你遇到的“无法将匿名类型转换为multipart”错误，是因为Cucumber把表达式里的内容当成默认字符串处理，无法直接转成MultipartFile对象。解决步骤如下：

1. 注册自定义参数类型 #

创建参数类型转换器，把.feature文件中传入的文件路径字符串转换成MultipartFile实例（这里用Spring的MockMultipartFile模拟，适配测试场景）：

import io.cucumber.java.ParameterType;
import org.springframework.mock.web.MockMultipartFile;
import org.springframework.web.multipart.MultipartFile;
import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;

public class CucumberParameterConverters {

    @ParameterType(".*") // 匹配任意格式的文件路径字符串
    public MultipartFile multipartFile(String filePath) throws IOException {
        File targetFile = new File(filePath);
        return new MockMultipartFile(
            targetFile.getName(),
            targetFile.getName(),
            "multipart/form-data", // 设置对应文件的Content-Type
            new FileInputStream(targetFile)
        );
    }
}

2. 在Step定义中使用自定义参数 #

现在可以直接在Step注解里用{multipartFile}来映射参数：

import io.cucumber.java.en.When;
import org.springframework.web.multipart.MultipartFile;

public class FileUploadSteps {

    @When("上传文件 {multipartFile}")
    public void handleFileUpload(MultipartFile file) {
        // 编写你的文件上传业务逻辑
        System.out.println("待上传文件名: " + file.getOriginalFilename());
        System.out.println("文件大小: " + file.getSize() + " bytes");
    }
}

3. 编写.feature用例 #

在Gherkin用例中传入项目可访问的文件路径即可：

Feature: 文件上传测试
  Scenario: 上传本地测试文件
    When 上传文件 "src/test/resources/test-upload.pdf"

注意事项 #

• 若使用MockMultipartFile，需确保项目引入spring-test依赖（Maven示例）：

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-test</artifactId>
    <version>5.3.24</version>
    <scope>test</scope>
</dependency>

• 优先使用项目相对路径，避免硬编码系统绝对路径，提升用例可移植性。

内容的提问来源于stack exchange，提问作者Utkarsha Deshmukh