React通过Axios发POST至Spring Boot后端返回400 Bad Request问题
核心问题根源
你的上传逻辑存在两个本质错误,和CORS配置、token鉴权都没有关系,是请求格式完全不符合multipart上传的规范要求:
- 手动配置的
multipart/form-data请求头是无效占位符
你写在代码里的boundary=<calculated when request is sent>是Postman的内置提示文本,不是真实可运行的请求参数。真实的请求分段分隔符(boundary)是浏览器在真正发送请求时随机生成的字符串,如果你提前把这个占位符写进请求头,后端根本没办法识别请求体的分段边界,直接就会抛出400 Bad Request。
如果你把这个Content-Type头整个删掉,axios默认会把请求体按JSON格式序列化发送,和后端要求的multipart格式不匹配,自然会触发500服务端内部错误。 - 没有构造合法的multipart请求体
你现在直接把{data: base64, name: 'file', type: 'image/jpeg'}这个普通JS对象当请求体传,哪怕Content-Type配置正确,对象序列化之后也是纯JSON文本,完全不符合multipart/form-data的格式要求,后端根本读不到对应的文件字段。
可直接落地的修复方案
- 删掉所有手动配置的
Content-Type: multipart/form-data相关代码
只保留需要的Authorization授权头即可。当浏览器检测到请求体是FormData实例时,会自动生成带正确随机boundary的multipart请求头,完全不需要手动干预。 - 用原生
FormDataAPI组装上传内容
如果是已经把图片转成base64字符串的场景,不要直接传base64当文件,需要先把base64转成可上传的二进制Blob对象,再追加到FormData实例里,替换后的正确代码如下:
如果是通过原生const uploadImage = (e) => { e.preventDefault(); const uploadData = async () => { const token = JSON.parse(localStorage.getItem('token')); // 初始化FormData实例 const formData = new FormData(); // 工具方法:把base64转成可上传的Blob对象 const base64ToBlob = (base64Str) => { const [_, base64Data] = base64Str.split(','); const mimeMatch = base64Str.match(/:(.*?);/); const mime = mimeMatch ? mimeMatch[1] : 'image/jpeg'; const byteArr = atob(base64Data); const len = byteArr.length; const uint8 = new Uint8Array(len); for(let i = 0; i < len; i++) { uint8[i] = byteArr.charCodeAt(i); } return new Blob([uint8], { type: mime }); } // 替换成项目里实际获取到的base64格式图片字符串 const base64Image = ''; const imageBlob = base64ToBlob(base64Image); // 第一个参数是后端要求的文件字段名,需要和你Postman里配置的字段名完全一致 formData.append('file', imageBlob, 'upload.jpg'); try { const res = await axios({ method: 'post', url: 'http://192.168.1.218:8080/api/image/upload', data: formData, headers: { "Authorization": `Bearer ${token}` // 绝对不要在这里手动配置multipart格式的Content-Type } }) console.log('上传成功', res.data) } catch (error) { console.log('上传异常', error) } } uploadData() }<input type="file">选择的图片,可以直接拿到原生File对象,完全不需要转base64再处理,直接把文件对象追加到FormData里即可,性能更好也更少出错。 - 和Postman配置做交叉校验
打开之前跑通的Postman接口配置,确认两个细节:- Body选项里选的是
form-data模式,对应的文件字段叫什么,代码里formData.append的第一个参数就要改成完全一致的字段名,大小写不能出错 - 不要直接把base64字符串作为普通文本字段传给后端,绝大多数后端的图片上传接口只识别二进制文件流,不解析纯base64文本
- Body选项里选的是
高频踩坑提醒
- 永远不要自己手动编写boundary值,不同浏览器的生成规则不一样,手动配置100%会导致后端解析失败
- 哪怕你手动把Content-Type写对为
multipart/form-data但没带对应的boundary,同样会触发400错误 - axios本身对FormData的适配是内置的,不需要额外安装插件或者调整全局请求拦截器的配置
内容的提问来源于stack exchange,提问作者Dirk
相关产品推荐
相关产品推荐

