这篇文章主要介绍了如何使用axios发送post请求上传文件到后端(multipart/form-data),本文给大家带来了问题原因及解决方案,结合实例代码给大家介绍的非常详细,需要的朋友可以参考下
  • 项目场景:
  • 原因分析:
  • 解决方案:
  • 项目场景:

    后端 :实现了一个文件上传服务接口,可以接收前端传递过来的MultipartFile文件,并存储到服务器本地中。
    前端 :获取 type file <font> 标签中的文件,使用 axios http请求库,发送 post 请求,将文件发送给后端。

    在js中发送上传文件请求的常规代码如下:

  • new 一个 FormData 对象,使用 append 方法将文件添加到表单中
  • FormData 专门用于js中发送 multipart/form-data 格式请求
  • append 方法的 key 为表单中的 name 属性,即后端需要接收的参数名
  • async handleUploadFile(event) {
      const file = event.target.files[0]
      let formData = new FormData()
      formData.append('files', file)
      const res = await service({
        url: '/api/files/upload',
        method: 'POST',
        headers: {
           'Content-Type': 'multipart/form-data'
        data: formData
      console.log(res.data);
    

    实际运行以上这段代码时,会发现后端报500错误如下:

    Caused by: java.io.IOException:
    org.apache.tomcat.util.http.fileupload.FileUploadException: the request was rejected because no multipart boundary was found

    大概的意思是说,后端无法识别到传递来的文件中的boundary,从而无法区分一个文件的内容从报文的哪个地方开始,又从报文的哪个地方结束,最终导致文件上传失败。

    原因分析:

    分析以上这种情况的原因,是因为我在发送请求时将请求头中Content-Type属性给写死为multipart/form-data浏览器无法自动给我们的报文添加boundary

    我尝试将前端请求config中,headers配置移除,如下:

    async handleUploadFile(event) {
      const file = event.target.files[0]
      let formData = new FormData()
      formData.append('files', file)
      const res = await service({
        url: '/api/files/upload',
        method: 'POST',
        data: formData
      console.log(res.data);
    

    再次发送请求,这次仍然没有请求成功。服务器没有报错了,但是后端获取不到文件数据。继续分析请求报文,发现属性值变为application/x-www-form-urlencoded,这是发送普通的表单,肯定是无法正确将文件送达的。

    解决方案:

    在查阅了网上大量的帖子之后得知,axios在请求发送出去之前会进行一次拦截,自动给我们的请求设置一些参数。上面会出现application/x-www-form-urlencoded这个参数就是因为axios设置了post请求的默认请求头,如果我们没有在config中指定其它请求头的话,就会使用默认的。

    又了解到,发送multipart/form-data格式的请求时,不需要我们自己指定Content-Type属性,由浏览器自动帮我们去设置。

    那么解决问题的关键就是不让axios帮我们自动配置

    axiosconfig中有一个transformRequest属性,官方的解释是可以在请求发送之前让我们人为干预。属性值是一个数组,里面可以定义一个函数,接收两个参数,分别是dataheadersdata就是我们刚刚定义的FormData对象,headers里面则是axios预定义的请求头。

    打印headers;

    async handleUploadFile(event) {
      const file = event.target.files[0]
      let formData = new FormData()
      formData.append('files', file)
      const res = await service({
        url: '/api/files/upload',
        method: 'POST',
        transformRequest: [function(data, headers) {
          // 去除post请求默认的Content-Type
          delete headers.post['Content-Type']
          return data
        data: formData
      console.log(res.data);