MockMvc测试：如何传递含文件与简单类型的复杂RequestBody对象

首先得指出你当前代码里的核心矛盾：你的控制器用@RequestBody接收ContributionNew<Photo>对象，但Photo里包含MultipartFile——这两种方式本质上是冲突的。@RequestBody是用来解析JSON/XML格式的请求体，而MultipartFile是multipart/form-data类型请求里的文件部分，没法直接序列化到JSON里。所以要解决这个问题，得先调整控制器的接收方式，再对应修改MockMvc测试用例。

第一步：调整控制器接口 #

把原来的@RequestBody改成@ModelAttribute，同时指定请求的consumes类型为multipart/form-data，这样Spring就能正确解析包含文件的复杂对象了：

@PostMapping(
    value = "/{id}/contributions/photos",
    consumes = MediaType.MULTIPART_FORM_DATA_VALUE
)
@ResponseStatus(HttpStatus.CREATED)
public ResponseEntity<Void> createPhotoContribution(
    @ApiParam(value = "The movie ID", required = true) @PathVariable("id") final Long id,
    @ApiParam(value = "The contribution", required = true) @ModelAttribute @Valid final ContributionNew<Photo> contribution
) { 
    // 你的业务逻辑
}

第二步：完善MockMvc测试用例 #

现在需要用MockMvc的multipart()方法来构建请求，而不是普通的post()。对于嵌套的字段（比如集合里的Photo对象的photo字段），要使用路径式的参数名（比如elementsToAdd[0].photo）来匹配实体类的结构。

完整的测试代码如下：

@Test 
public void testCreatePhotoContribution() throws Exception { 
    // 1. 创建测试用的MockMultipartFile，参数名要对应嵌套字段路径
    MockMultipartFile testPhoto = new MockMultipartFile(
        "elementsToAdd[0].photo", 
        "test.png", 
        "image/png", 
        "Spring Framework test image".getBytes()
    );

    // 2. 构建multipart请求
    mockMvc.perform(multipart("/api/v1.0/movies/{id}/contributions/photos", 1)
            // 添加文件
            .file(testPhoto)
            // 添加其他简单类型字段，比如comment
            .param("comment", "Test photo contribution")
            // 如果需要测试idsToDelete，用索引式参数名
            .param("idsToDelete[0]", "1001")
            // 指定请求类型
            .contentType(MediaType.MULTIPART_FORM_DATA))
        .andExpect(status().isCreated());
}

关键说明 #

• 为什么用multipart()而不是post()？因为multipart/form-data请求的结构和普通JSON请求完全不同，MockMvc专门提供了multipart()方法来处理这种包含文件的请求。
• 参数名的规则：对于集合类型的字段（比如elementsToAdd），用[索引]来定位集合中的元素，再加上字段名（比如.photo），Spring会自动把这些参数绑定到ContributionNew对象的对应属性里。
• 如果你的业务逻辑必须用JSON格式传递对象（保留@RequestBody），那只能把MultipartFile换成Base64字符串传输，但这种方式对大文件不友好，不推荐在实际项目中使用。

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