You need to enable JavaScript to run this app. React通过Axios发POST至Spring Boot后端返回400 Bad Request问题
优惠活动
大模型
产品
解决方案
定价
更多

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的格式要求,后端根本读不到对应的文件字段。
可直接落地的修复方案
  1. 删掉所有手动配置的Content-Type: multipart/form-data相关代码
    只保留需要的Authorization授权头即可。当浏览器检测到请求体是FormData实例时,会自动生成带正确随机boundary的multipart请求头,完全不需要手动干预。
  2. 用原生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里即可,性能更好也更少出错。
  3. 和Postman配置做交叉校验
    打开之前跑通的Postman接口配置,确认两个细节:
    • Body选项里选的是form-data模式,对应的文件字段叫什么,代码里formData.append的第一个参数就要改成完全一致的字段名,大小写不能出错
    • 不要直接把base64字符串作为普通文本字段传给后端,绝大多数后端的图片上传接口只识别二进制文件流,不解析纯base64文本
高频踩坑提醒
  • 永远不要自己手动编写boundary值,不同浏览器的生成规则不一样,手动配置100%会导致后端解析失败
  • 哪怕你手动把Content-Type写对为multipart/form-data但没带对应的boundary,同样会触发400错误
  • axios本身对FormData的适配是内置的,不需要额外安装插件或者调整全局请求拦截器的配置

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.15 15:15:04