You need to enable JavaScript to run this app. React Native FlatList中URL多文件下载并显示单独进度条的实现问题
优惠活动
大模型
产品
解决方案
定价
更多

React Native FlatList中URL多文件下载并显示单独进度条的实现问题

问题根因

  • 进度回调触发过于频繁:RNFS默认的下载进度回调会在每次收到字节流时触发,每秒可达数十次,频繁调用setDownloadProgress会导致JS线程被重渲染任务占满,阻塞UI响应
  • 后台下载配置无效:你写的background: true位于mkdir的then回调块内,不属于downloadFile的配置参数,完全未生效,所有下载任务都在前台线程运行,抢占UI资源
  • 无重复点击/并发控制:未限制同时运行的下载任务数,也没有拦截重复点击下载按钮的逻辑,可能同时触发大量下载任务,进一步挤压运行资源

修复方案

直接修改下载逻辑即可解决卡顿、多下载失效问题,核心优化点如下:

  1. 配置RNFS自带的progressInterval参数,限制进度回调的触发频率,减少不必要的状态更新
  2. 将background参数正确放入下载配置中,开启后台下载,避免抢占前台UI线程资源
  3. 新增下载状态标记,拦截重复点击,避免同一个文件触发多次下载
  4. 可选:如果需要同时下载10个以上文件,可新增全局并发队列,限制最多同时运行2-3个下载任务,避免IO资源耗尽

核心修改代码

import {useCallback, useRef, useState} from 'react';
// 其余原有导入保持不变

const DownloadItem = ({title, downloadUrl}) => {
  const [downloadProgress, setDownloadProgress] = useState(0);
  // 新增ref:标记当前是否正在下载,避免重复触发
  const isDownloading = useRef(false);
  // 新增ref:记录上次进度更新时间,兜底控制更新频率
  const lastUpdateTime = useRef(Date.now());

  const startDownloadZip = useCallback(async () => {
    if (isDownloading.current) return;
    isDownloading.current = true;

    const appParentPath = RNFS.DocumentDirectoryPath;
    const appFolderPath = appParentPath + '/MyFiles';
    try {
      await RNFS.mkdir(appFolderPath);
      const downloadTask = RNFS.downloadFile({
        fromUrl: downloadUrl,
        toFile: `${appFolderPath}/${title}`,
        background: true, // 正确开启后台下载
        progressInterval: 200, // 配置进度回调每200ms触发一次,单位ms
        progress: (res) => {
          const now = Date.now();
          // 再加一层节流兜底,避免极端场景下回调过频
          if (now - lastUpdateTime.current < 200) return;
          lastUpdateTime.current = now;
          const progressPercent = res.bytesWritten / res.contentLength;
          setDownloadProgress(progressPercent);
        },
      });
      await downloadTask.promise;
      // 下载完成后重置状态,可根据需求修改为下载完成隐藏按钮等逻辑
      isDownloading.current = false;
    } catch (err) {
      console.log('下载错误', err);
      isDownloading.current = false;
    }
  }, [title, downloadUrl]);

  return (
    <View>
      <View style={style.parentView}>
        <View
          style={{
            height: 55,
            width: 55,
            borderRadius: 2,
            alignItems: 'center',
            backgroundColor: rendomRGB(),
          }}>
          <Text style={style.extensionTxt}>
            {getFirstCharacterOfExtensionFromURL(downloadUrl)}
          </Text>
        </View>

        <View>
          <Text style={style.fileTitle}>{title}</Text>
          <Text style={style.fileDesc}>{title}</Text>
          <View style={style.progressView}>
            <Progress.Bar
              style={style.fileDesc}
              progress={downloadProgress}
              width={200}
            />
            <TouchableOpacity
              // 下载过程中可设置按钮半透,提示用户不可点击
              style={{opacity: isDownloading.current ? 0.5 : 1}}
              onPress={startDownloadZip}>
              <Image
                style={style.imgCloseResume}
                source={require('../../assets/close.png')}
              />
            </TouchableOpacity>
          </View>
        </View>
      </View>

      <View style={style.deviderView}></View>
    </View>
  );
};

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.10 21:57:02