Spring MVC中Required MultipartFile参数'file'不存在问题排查求助

以下是针对该错误的具体排查方向和解决办法：

1. 前端上传逻辑缺失或错误 #

当前仅给出了文件选择的input标签，但未提供核心的上传逻辑。必须确保上传时正确构建FormData并传递文件：

• 创建FormData对象，以file为键添加选中的文件（键名需和后端@RequestParam的name严格一致）
• Angular中无需手动设置Content-Type为multipart/form-data，让浏览器自动处理即可

示例正确的Angular上传逻辑：

$scope.uploadFile = function(element) {
    var file = element.files[0];
    var formData = new FormData();
    formData.append('file', file); // 键名必须与后端参数名匹配

    $http.post('/media', formData, {
        transformRequest: angular.identity,
        headers: {'Content-Type': undefined}
    }).then(function(response) {
        // 处理成功响应
    }, function(error) {
        // 处理错误
    });
};

2. MultipartResolver配置问题 #

检查配置类的有效性：

• 确保配置类添加了@Configuration注解，被Spring容器扫描并加载
• 若为Spring Boot项目，推荐使用StandardServletMultipartResolver替代CommonsMultipartResolver，依赖Servlet容器原生支持更轻量：

@Configuration
public class MultipartConfig {
    @Bean
    public MultipartResolver multipartResolver() {
        StandardServletMultipartResolver resolver = new StandardServletMultipartResolver();
        return resolver;
    }
}

同时可通过配置文件简化上传参数设置：

spring.servlet.multipart.max-file-size=90MB
spring.servlet.multipart.max-request-size=90MB
spring.servlet.multipart.enabled=true

3. 请求路径匹配问题 #

确认前端请求的路径与后端@RequestMapping(value = "/media")完全一致，注意是否包含项目上下文路径（如项目名前缀）导致请求地址错误。

4. 参数名称一致性检查 #

确保前端FormData中添加文件的键名是file，与后端@RequestParam(name = "file")的name属性完全匹配（大小写敏感）。

5. 拦截器/过滤器干扰排查 #

检查项目中的拦截器或过滤器，是否存在提前读取请求体的逻辑，导致Spring无法解析Multipart数据。这类操作会破坏Multipart请求的结构，导致参数丢失。

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