Angular向Spring Boot传文件报错：Current request is not a multipart request

出现org.springframework.web.multipart.MultipartException: Current request is not a multipart request错误，核心原因是前端发送的请求不符合multipart/form-data格式要求，或后端配置存在异常，以下是具体排查和修复方案：

1. 避免手动设置Content-Type请求头 #

当使用FormData作为请求体时，Angular的HttpClient会自动生成正确的Content-Type: multipart/form-data请求头（包含必要的boundary标识）。如果手动设置该头，会丢失boundary信息，导致后端无法识别请求类型。

如果项目中有全局请求拦截器，需排除上传文件的请求：

// 示例拦截器逻辑
intercept(request: HttpRequest<any>, next: HttpHandler): Observable<HttpEvent<any>> {
  // 排除上传接口，保留自动生成的请求头
  if (request.url.includes('/uploadFile')) {
    return next.handle(request);
  }
  // 其他请求设置默认Content-Type
  const modifiedReq = request.clone({
    headers: request.headers.set('Content-Type', 'application/json')
  });
  return next.handle(modifiedReq);
}

2. 确认请求URL与后端接口匹配 #

检查Angular中this.url的值是否完全对应Spring Boot的/uploadFile接口路径，避免因URL错误导致后端接收的请求并非预期的上传接口。

3. 验证FormData构造正确性 #

确保formParams.append('file', file)中的参数名file，与后端@RequestParam("file")的参数名完全一致（大小写敏感）。可以通过浏览器开发者工具验证：

• 打开F12 → 切换到Network标签
• 触发上传请求，查看请求的Payload，确认file字段存在且包含文件内容

4. 检查Spring Boot Multipart配置（可选） #

Spring Boot默认启用multipart支持，若自定义过配置，需确保配置正确：

# application.yml 示例配置
spring:
  servlet:
    multipart:
      enabled: true
      max-file-size: 10MB
      max-request-size: 10MB

修复后的Angular代码示例 #

确保uploadfile方法不手动设置Content-Type：

public uploadfile(file: File, url: string) {
    let formParams = new FormData();
    formParams.append('file', file);
    // 不要添加手动设置Content-Type的代码
    return this.httpClient.post(url, formParams);
}

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