You need to enable JavaScript to run this app. 使用jQuery Ajax提交含文件上传的表单时Spring Boot抛非multipart请求异常
优惠活动
大模型
产品
解决方案
定价
更多

使用jQuery Ajax提交含文件上传的表单时Spring Boot抛非multipart请求异常

问题根因

当前抛出org.springframework.web.multipart.MultipartException: Current request is not a multipart request的核心原因有两点:

  • jQuery Ajax配置本身不识别enctype参数,这个属性是原生HTML表单的标签属性,写在Ajax配置项里不会被解析生效,因此你配置的multipart/form-data编码类型完全没有作用。
  • 你当前使用的$("body form:first").serialize()方法,仅能将普通文本类表单元素序列化为application/x-www-form-urlencoded格式的键值对字符串,完全无法读取文件上传控件中的文件二进制内容,也不支持生成multipart格式要求的、带分隔边界的请求体结构。
  • 最终抓包结果显示请求的Content-Type为默认的application/x-www-form-urlencoded,但后端接口要求接收MultipartFile[]类型的文件参数,二者格式不匹配,直接触发上述异常。
修复方案

替换原有表单序列化逻辑,使用浏览器原生的FormData对象构造请求体,配合两个关键Ajax配置,让请求正确以multipart格式发送:

  • 移除无实际作用的enctype: 'multipart/form-data'配置项。
  • 用原生DOM的FormData对象收集整个表单的所有字段,包括普通输入项、单复选框、文件控件的内容,无需手动拼接参数,完美适配你页面里50-60个表单元素的场景。
  • 新增两个必要的Ajax配置:
    • contentType: false:关闭jQuery自动设置请求Content-Type的逻辑,让浏览器自动生成带分隔边界的标准multipart请求头,避免手动指定类型丢失boundary参数导致后端解析失败。
    • processData: false:关闭jQuery自动将请求数据序列化为字符串的逻辑,让FormData对象以原生格式直接发送。

修正后的前端请求代码示例

// 获取页面对应的表单DOM元素
const targetForm = document.querySelector("body form:first");
// 构造FormData实例,自动收集表单内所有字段和文件内容
const formData = new FormData(targetForm);

$.ajax({
  url: "/createpo",
  type: "POST",
  dataType: "text",
  data: formData,
  // 关闭自动设置请求头
  contentType: false,
  // 关闭自动序列化请求数据
  processData: false
})
适配验证说明
  • 现有后端接口代码不需要任何修改:Spring MVC的参数绑定逻辑兼容FormData提交的字段格式,你文件控件的name为partfiles[]、后端参数名为partfiles的写法是Spring支持的常规绑定规则,匹配度没有问题。
  • 提交后可再次抓包确认:请求的Content-Type会自动变为带boundary的multipart/form-data格式,普通表单字段和文件流都会被正确拆分传输,后端就能正常同时接收普通表单模型和多文件数组参数。

内容的提问来源于stack exchange,提问作者fatherazrael

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.17 04:15:05