前后端联调必备：用@RequestPart搞定multipart/form-data表单提交（SpringBoot实战）

原创

于 2026-02-21 10:29:09 发布 · 183 阅读

标签

前后端联调实战：SpringBoot中@RequestPart处理multipart/form-data的深度解析

在电商后台管理系统开发中，我们经常遇到这样的需求：用户需要同时上传商品图片和填写详细的商品参数表单。传统的表单提交方式无法同时处理文件和非文件数据，而multipart/form-data格式正是为解决这类复合数据场景而生。作为全栈开发者，掌握SpringBoot中@RequestPart注解的高效用法，能显著提升前后端协作效率。

1. multipart/form-data的本质与工作流程

multipart/form-data是HTTP协议中用于表单数据提交的一种编码类型，特别适合同时传输二进制文件和文本数据。与application/x-www-form-urlencoded不同，它使用边界分隔符(boundary)将表单的不同部分隔开，每个部分可以有自己的内容类型。

典型的工作流程如下：

前端构造FormData对象并添加字段

const formData = new FormData();
formData.append('productImage', fileInput.files[0]);
formData.append('productInfo', JSON.stringify({
  name: '智能手表',
  price: 1299,
  stock: 50
}));