Angular调用Spring Boot文件上传接口报500：请求Payload为空

问题核心在于前后端请求格式不匹配：后端通过@RequestParam("file")接收multipart/form-data类型的文件，而前端将Blob封装到JSON对象中发送，导致后端无法解析请求体，触发500错误。以下是具体修正步骤：

1. 调整Angular请求逻辑：改用FormData传递文件 #

放弃JSON格式的ImportXetraRequest，直接用FormData封装文件（这是multipart/form-data请求的标准方式）。

Angular服务代码示例 #

import { HttpClient } from '@angular/common/http';
import { Injectable } from '@angular/core';

@Injectable({ providedIn: 'root' })
export class XetraUploadService {
  constructor(private http: HttpClient) {}

  uploadFile(file: File) {
    const formData = new FormData();
    // 键名必须与后端@RequestParam的参数名"file"完全一致
    formData.append('file', file);
    // 无需手动设置Content-Type，浏览器会自动生成带boundary的正确头
    return this.http.post('/xetra', formData);
  }
}

2. 修正PrimeNG p-fileUpload组件配置 #

使用自定义上传模式，直接获取文件对象传递给服务：

组件模板代码 #

<p-fileUpload
  customUpload="true"
  (uploadHandler)="handleUpload($event)"
  accept=".csv,.xlsx" <!-- 根据实际支持的文件类型调整 -->
  maxFileSize="10000000" <!-- 限制文件大小，单位字节 -->
>
</p-fileUpload>

组件逻辑代码 #

import { Component } from '@angular/core';
import { XetraUploadService } from './xetra-upload.service';

@Component({
  selector: 'app-xetra-upload',
  templateUrl: './xetra-upload.component.html'
})
export class XetraUploadComponent {
  constructor(private uploadService: XetraUploadService) {}

  handleUpload(event: any) {
    const targetFile = event.files[0];
    this.uploadService.uploadFile(targetFile).subscribe({
      next: (res) => {
        console.log('上传成功', res);
        // 清空文件列表，重置组件状态
        event.files = [];
      },
      error: (err) => {
        console.error('上传失败', err);
        // 展示错误提示等逻辑
      }
    });
  }
}

3. 验证后端接口配置 #

确保Spring Boot的Controller和配置正确：

后端Controller代码 #

import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;

@RestController
public class XetraController {

    @PostMapping("/xetra")
    public String processXetraFile(@RequestParam("file") MultipartFile file) {
        if (file.isEmpty()) {
            return "上传的文件不能为空";
        }
        // 这里添加文件解析、存储等业务逻辑
        return String.format("文件%s上传成功，大小：%d字节", 
                            file.getOriginalFilename(), file.getSize());
    }
}

补充后端配置（可选） #

如果上传文件较大，需在application.properties中调整文件大小限制：

spring.servlet.multipart.max-file-size=10MB
spring.servlet.multipart.max-request-size=10MB

关键注意事项 #

• 禁止手动设置Content-Type: multipart/form-data，否则会丢失浏览器自动生成的boundary参数，导致后端无法解析请求体
• 确保FormData.append的键名与后端@RequestParam的参数名完全一致
• 若需传递其他参数，可通过formData.append("paramName", paramValue)添加，后端用@RequestParam接收对应参数

内容的提问来源于stack exchange，提问作者ms88-aut