Angular用Http发送formData POST请求时Spring Boot报MissingServletRequestPartException

这个错误核心就是后端没收到名为file的请求部件，结合你用Angular旧版Http模块的情况，大概率是请求构造时的multipart/form-data处理出了问题，我给你一步步梳理解决方法：

常见坑点：手动设置Content-Type #

当你手动给请求头添加Content-Type: multipart/form-data;boundary=xxx时，很容易出现boundary和实际请求中FormData生成的不匹配，导致后端无法正确解析表单数据，这是最常见的原因。

正确的Angular代码实现 #

你需要去掉手动设置的Content-Type，让浏览器自动生成正确的请求头，同时确保FormData里的键名和后端要求的file完全一致：

updateUserProfilePicViaHttp(userId: number, imageFile: File) {
    // 1. 构造FormData，键名必须是'file'，和后端@RequestParam的名称对应
    const formData = new FormData();
    formData.append('file', imageFile);
    // 如果需要传递userId，可以选择加到FormData里或者放在URL路径中
    formData.append('userId', userId.toString());

    // 2. 不要手动设置Content-Type！浏览器会自动处理带正确boundary的请求头
    const headers = new Headers();
    // 移除 headers.append('Content-Type', 'multipart/form-data;boundary=...') 这行代码

    const requestOptions = new RequestOptions({ headers: headers });

    return this.http.post('/api/users/profile-pic', formData, requestOptions)
        .map(res => res.json())
        .catch(error => {
            console.error('头像上传失败:', error);
            return Observable.throw(error);
        });
}

后端对应代码确认 #

确保Spring Boot接口的参数名称和前端FormData的键名完全匹配（大小写敏感）：

@PostMapping("/api/users/profile-pic")
public ResponseEntity<String> updateUserProfilePic(
        @RequestParam("file") MultipartFile profilePic,
        @RequestParam("userId") Integer userId) {
    // 这里处理文件上传逻辑，比如保存到服务器或者OSS
    return ResponseEntity.ok("头像上传成功");
}

额外排查点 #

• 确认传入的imageFile是有效的File对象，调用方法前可以用console.log(imageFile)检查是否有值、是否是File类型。
• 如果后端使用@RequestPart注解，也要确保注解里的名称是file，和前端一致。
• 检查请求的API路径是否正确，避免发送到错误的端点导致后端没处理到请求。

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