文档开发者中心
我的
|

HarmonyOS 6

HarmonyOS 5

axios如何批量上传文件

如何通过axios调用后端接口上传多个文件,同时携带其他参数?

点赞
收藏
回复
4
分享
举报
浏览87 发布于2026-04-30 07:20未知归属地
全部评论
最多点赞
最新发布
最早发布
一年2000多个帖子,怎么做到的
3楼回复于2026-05-12 15:31 来自山东
大佬, 你是个人开发者吗? 看你这生产力也太牛了
2楼回复于2026-05-12 15:31 来自山东

【背景知识】

  1. axios:基于Promise的JavaScript HTTP客户端,用于浏览器和Node.js环境。它可以发送HTTP请求并支持诸如请求和响应拦截、转换数据、取消请求以及自动转换JSON数据等功能。
  2. FormData:用于在客户端创建表单数据,可以将表单字段的键值对以键值对的方式添加。在文件上传的场景中,我们可以使用FormData对象来收集表单数据,包括文件和其他文本字段,然后将其发送到后端服务器。

【解决方案】

  1. 该方案基于axios@2.2.7,执行ohpm install @ohos/axios@2.2.7命令安装axios三方库。
  2. 将待上传的文件拷贝到沙箱目录中,读取文件流数据后,添加到表单数据中,示例代码如下:
收起
自动换行
深色代码主题
复制
 
async uploadFile(context: Context, url: string, filenames: string[]): Promise {
  let result: Result = {};
  if (!filenames || filenames.length < 1) {
    return result;
  }
  // axios表单数据
  let formData = new FormData();
  // 表单也可以添加非文件类型参数
  formData.append('type', 258);

  // 将待上传文件预置于resources目录下的resfile目录,应用安装后,resfile资源会被解压到应用沙箱路径
  // 但是仅能以只读方式访问,所以也需要将其文件复制到沙箱目录下进行读写。
  let resourceDir = context.resourceDir;
  // 获取缓存目录
  const cacheDir = context.cacheDir;
  for (let filename of filenames) {
    let resFilePath = resourceDir + '/' + filename;
    let cacheFilePath = cacheDir + '/' + filename;
    try {
      // 将resfile资源文件拷贝至缓存目录中
      const oldFile = fs.openSync(resFilePath, fs.OpenMode.READ_ONLY);
      fs.copyFileSync(oldFile.fd, cacheFilePath);

      let file = fs.openSync(cacheFilePath, fs.OpenMode.READ_WRITE);
      let stat = fs.lstatSync(cacheFilePath);
      let buf = new ArrayBuffer(stat.size);
      // 以同步方法从流文件读取数据。
      fs.readSync(file.fd, buf);
      fs.fsyncSync(file.fd);
      fs.closeSync(file.fd);

      // 将文件流添加至表单数据中
      formData.append('files', buf, { filename: filename });
    } catch (err) {
      hilog.error(0x0000, 'testTag', 'uploadFile copyFileSync fail %{public}s', JSON.stringify(err) ?? '');
    }
  }

  try {
    let res: AxiosResponse = await axios.post, FormData>(url, formData,
      {
        // 指定请求头中ContentType未表单类型
        headers: { 'Content-Type': 'multipart/form-data' },
        onUploadProgress: (progressEvent: AxiosProgressEvent): void => {
          let onUploadProgress = progressEvent && progressEvent.loaded && progressEvent.total ?
            Math.ceil(progressEvent.loaded / progressEvent.total * 100) : 0;
          hilog.info(DOMAIN, 'testTag', 'upload onUploadProgress %{public}s', onUploadProgress + '%');
        },
      });
    result.statue = res ? JSON.stringify(res.status) : '';
    result.data = res ? JSON.stringify(res.data) : '';
    result.statusText = res ? res.statusText : '';
  } catch (err) {
    hilog.error(0x0000, 'testTag', 'uploadFile fail %{public}s', JSON.stringify(err) ?? '');
  }
  return result;
}

axios批量上传文件的完整示例代码如下:

收起
自动换行
深色代码主题
复制
 
import { hilog } from '@kit.PerformanceAnalysisKit';
import { BusinessError } from '@kit.BasicServicesKit';
import axios from '@ohos/axios';
import { AxiosResponse, FormData, AxiosProgressEvent} from '@ohos/axios';
import fs from '@ohos.file.fs';

/**
 * axios文件批量上传多个文件
 * */
const DOMAIN: number = 0x0000;

@Entry
@Component
struct Index {
  scroller: Scroller = new Scroller();
  private context: Context = this.getUIContext().getHostContext() as Context;

  baseUrl: string = 'xxx.xxx.xxx.xxx';
  uploadUrl: string = this.baseUrl + '/batchUploadFile';
  filenames: string[] = ['test1.png', 'test2.png'];

  private axiosUtil = AxiosUtil.getInstance(this.baseUrl);

  build() {
    Scroll(this.scroller) {
      Column() {
        Button('批量上传文件').width(100).margin({
          bottom: 10,
          right: 10
        })
          .onClick(() => {
            this.axiosUtil.uploadFile(this.context, this.uploadUrl, this.filenames)
              .then((res) => {
                hilog.info(DOMAIN, 'testTag', '%{public}s', JSON.stringify(res) ?? '');
              })
              .catch((err: BusinessError) => {
                hilog.error(DOMAIN, 'testTag', 'err code == %{public}s msg == %{public}s', err.code, err.message);
              });
          })
      }
    }
    .scrollable(ScrollDirection.Vertical) // 滚动方向纵向
    .scrollBar(BarState.On) // 滚动条常驻显示
    .margin({ left: 10, right: 10 })
  }
}

export class AxiosUtil {
  private static instance: AxiosUtil = new AxiosUtil();

  public static getInstance(url: string) {
    AxiosUtil.instance.create(url);
    return AxiosUtil.instance;
  }

  // axios: AxiosInstance
  create(baseUrl?: string): Result {
    axios.defaults.baseURL = baseUrl;
    hilog.info(DOMAIN, 'testTag', '%{public}s', JSON.stringify(axios.defaults.baseURL) ?? '');
    return { currentBaseUrl: baseUrl };
  }

  async uploadFile(context: Context, url: string, filenames: string[]): Promise {
    let result: Result = {};
    if (!filenames || filenames.length < 1) {
      return result;
    }
    // axios表单数据
    let formData = new FormData();
    // 表单也可以添加非文件类型参数
    formData.append('type', 258);

    // 将待上传文件预置于resources目录下的resfile目录,应用安装后,resfile资源会被解压到应用沙箱路径
    // 但是仅能以只读方式访问,所以也需要将其文件复制到沙箱目录下进行读写。
    let resourceDir = context.resourceDir;
    // 获取缓存目录
    const cacheDir = context.cacheDir;
    for (let filename of filenames) {
      let resFilePath = resourceDir + '/' + filename;
      let cacheFilePath = cacheDir + '/' + filename;
      try {
        // 将resfile资源文件拷贝至缓存目录中
        const oldFile = fs.openSync(resFilePath, fs.OpenMode.READ_ONLY);
        fs.copyFileSync(oldFile.fd, cacheFilePath);

        let file = fs.openSync(cacheFilePath, fs.OpenMode.READ_WRITE);
        let stat = fs.lstatSync(cacheFilePath);
        let buf = new ArrayBuffer(stat.size);
        // 以同步方法从流文件读取数据。
        fs.readSync(file.fd, buf);
        fs.fsyncSync(file.fd);
        fs.closeSync(file.fd);

        // 将文件流添加至表单数据中
        formData.append('files', buf, { filename: filename });
      } catch (err) {
        hilog.error(0x0000, 'testTag', 'uploadFile copyFileSync fail %{public}s', JSON.stringify(err) ?? '');
      }
    }

    try {
      let res: AxiosResponse = await axios.post, FormData>(url, formData,
        {
          // 指定请求头中ContentType未表单类型
          headers: { 'Content-Type': 'multipart/form-data' },
          onUploadProgress: (progressEvent: AxiosProgressEvent): void => {
            let onUploadProgress = progressEvent && progressEvent.loaded && progressEvent.total ?
              Math.ceil(progressEvent.loaded / progressEvent.total * 100) : 0;
            hilog.info(DOMAIN, 'testTag', 'upload onUploadProgress %{public}s', onUploadProgress + '%');
          },
        });
      result.statue = res ? JSON.stringify(res.status) : '';
      result.data = res ? JSON.stringify(res.data) : '';
      result.statusText = res ? res.statusText : '';
    } catch (err) {
      hilog.error(0x0000, 'testTag', 'uploadFile fail %{public}s', JSON.stringify(err) ?? '');
    }
    return result;
  }
}

export interface Result {
  // currentBaseUrl 当前BaseUrl
  currentBaseUrl?: string,
  // status 来自服务器响应的 HTTP 状态码
  statue?: string
  // data 由服务器提供的响应
  data?: string
  // statusText 来自服务器响应的 HTTP 状态信息
  statusText?: string,
}

【总结】 服务端使用MultipartFile[]接受多个文件,表单参数名称需要和上述示例代码中的FormData传参一一对应。示例如下:

收起
自动换行
深色代码主题
复制
@PostMapping("/batchUploadFile")
public String batchUploadFile(
  @RequestParam(name = "type", required = false) Integer type,
  @RequestPart(name = "files", required = false) MultipartFile[] files) {
    // 服务端业务逻辑
}
展开全部
1
1楼回复于2026-04-30 07:20 未知归属地
  • hid70511339

    大佬,下面这行代码不完整 

    收起
    自动换行
    深色代码主题
    复制
    let res: AxiosResponse = await axios.post, FormData>(url, formData,
    2026-05-19 14:26 来自江苏
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。