Spring Boot测试：MockMultipartFile未纳入MockHttpServletRequest原因排查

• 超过MockMvc默认文件大小限制
  MockMvc默认对multipart请求的单文件大小、请求总大小有严格阈值，当超大图片超过限制时，请求会被提前拦截，文件无法被解析到MockHttpServletRequest中。需要初始化MockMvc时显式调整限制，示例代码：

mockMvc = MockMvcBuilders.webAppContextSetup(context)
    .apply(MockMvcConfigurers.multipartConfig(new MockMultipartConfigBuilder()
        .setMaxFileSize(100 * 1024 * 1024) // 单文件最大100MB
        .setMaxRequestSize(100 * 1024 * 1024) // 请求总大小最大100MB
        .build()))
    .build();

• 请求构造未正确使用multipart方式
  如果测试请求用普通post()/get()方法添加文件参数，而不是multipart()方法，MockMvc不会将请求识别为multipart类型，自然不会把MockMultipartFile注入到MockHttpServletRequest中。正确构造方式：

mockMvc.perform(multipart("/upload") // 明确指定multipart请求
    .file(mockMultipartFile) // 添加文件
    .param("otherParam", "value"));

• Spring Boot全局Multipart配置限制
  若项目配置文件中设置的spring.servlet.multipart.max-file-size、spring.servlet.multipart.max-request-size小于超大图片大小，即使MockMvc调整了限制，服务器端仍会拦截请求。测试时可通过@TestPropertySource临时覆盖配置：

@TestPropertySource(properties = {
    "spring.servlet.multipart.max-file-size=100MB",
    "spring.servlet.multipart.max-request-size=100MB"
})

• MockMultipartFile构造参数错误
  如果构造时传入的InputStream为空/已关闭，或ContentType设置错误（未指定图片类型如image/jpeg），会导致文件无法被正确解析。确保参数有效，示例：

MockMultipartFile file = new MockMultipartFile(
    "file", // 需和控制器接收的参数名一致
    "test.jpg",
    "image/jpeg",
    new FileInputStream(new File("path/to/large/image.jpg"))
);

• 请求路径或方法不匹配
  若测试请求的路径、HTTP方法和控制器的@RequestMapping/@PostMapping等注解不匹配，请求会被路由到错误逻辑（甚至404），此时MockHttpServletRequest中不会包含上传文件。检查测试代码的请求路径、方法是否和控制器完全一致。

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