React Native后台上传大视频附带参数问题及替代方案咨询

一、现有react-native-background-upload库的问题修复 #

你遇到的无法附带其他参数的问题不需要更换库即可解决，该库的multipart上传模式支持parameters配置项，用于传递额外的表单字段，修改你的配置代码如下即可满足后端接口要求：

const options = {
  url: url,
  path: pathToVideoFile,
  method: 'POST',
  field: 'video',
  type: 'multipart',
  // 新增以下配置传递额外参数
  parameters: {
    projectId: 你的项目ID数值,
    title: '你的视频标题文本'
  }
};

二、可选替代方案 #

如果有更多自定义需求（比如分片上传、更灵活的进度控制），可选择以下成熟方案：

• react-native-blob-util：是原react-native-fetch-blob的活跃维护分支，支持后台上传、multipart表单传参、断点续传、进度监听等能力，适配iOS和Android的后台权限要求，是目前文件上传场景使用最广泛的库之一。
• expo-file-system：如果你的项目基于Expo开发，可以使用该内置模块的uploadAsync方法，支持后台模式和multipart参数传递，接入成本更低。

三、react-native-background-fetch适用性说明 #

react-native-background-fetch不适用于大视频上传场景，该库的能力是实现APP退到后台后周期性唤醒执行短耗时任务，无法处理大文件上传这类长耗时的IO操作，也不提供文件上传、参数拼接、进度回调等相关能力，不要用于该场景。

四、最优方案建议 #

针对大视频后台上传场景，推荐按优先级选择方案：

1. 优先使用已接入的react-native-background-upload，补充parameters配置即可快速满足需求，改造成本最低
2. 如果视频大小超过100M，建议额外实现分片上传逻辑，将大文件切分为1-5M的分片依次上传，失败时仅重传失败分片，避免网络波动导致整个文件重传
3. 双端额外配置后台权限：iOS开启Background Modes的Background Fetch权限，Android配置前台服务通知，避免上传过程被系统回收进程

内容的提问来源于stack exchange，提问作者Tushar Khatiwada