使用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
相关产品推荐
相关产品推荐

