You need to enable JavaScript to run this app. 基于原生DnD与浏览器API实现文件上传,递归构建文件树仅返回首个结果
优惠活动
大模型
产品
解决方案
定价
更多

基于原生DnD与浏览器API实现文件上传,递归构建文件树仅返回首个结果

异常产生的核心成因

所有问题的根源是你当前实现的文件树构建逻辑全为异步回调模式,但你在同步执行流中立刻对未完成构建的文件树做了读取、序列化操作,具体的时序错位逻辑可以拆解为两部分:

  • 所有涉及文件/目录的读取操作,都是浏览器侧的异步回调:
    • entry.file() 获取文件元信息的操作,回调执行时机在当前同步代码块跑完之后
    • dirReader.readEntries() 读取目录下条目的操作,回调执行时机也在当前同步代码块跑完之后
    • 递归遍历过程中的每一层目录读取、每一个文件拉取,都会依次进入异步任务队列排队执行,不会阻塞当前的同步代码流程
  • DevTools的打印特性放大了问题的迷惑性:

    console.log 打印普通对象时,不会存储打印时刻的对象快照,而是存储对象的内存引用。当所有异步任务执行完成、文件树被补全全量数据后,你点开控制台查看打印的对象时,读到的是已经填充完整的最新内存值,所以会误以为打印时刻的文件树就是完整的。
    而你紧接着执行的JSON.stringify()、Object.keys()是同步代码,运行时机在所有异步任务入队之后、但还没开始执行的阶段,这时候文件树里只写入了最开始同步流程能碰到的1个根条目,自然只会拿到1条的结果。

排查验证方法

可以通过两个简单操作快速验证上述成因:

  • 把原来的console.log(finalFiles)替换为console.log(JSON.parse(JSON.stringify(finalFiles))),这是强制打印时刻的对象快照,你会看到输出结果和你序列化拿到的单条结果完全一致,根本不是全量数据
  • 把同步执行的JSON.stringify(finalFiles)、Object.keys(finalFiles).length挪到setTimeout延时回调里(比如延时1000ms再执行),等所有异步任务跑完后再读文件树,你会立刻拿到全量的正确数据。
解决方案

需要把原来基于回调的异步逻辑改造为Promise模式,等所有遍历、文件读取的异步操作全部完成后,再向外返回完整的文件树,具体改造点包括:

  • 把单个文件元信息获取、单批次目录读取的回调逻辑包装成可await的Promise
  • 适配浏览器File System API的规则:dirReader.readEntries() 单次最多返回100个目录条目,必须循环调用直到返回空数组,才算读完目录下的全部内容
  • 所有递归遍历逻辑增加异步等待,等当前节点的所有子节点全部遍历完成后,才算当前节点处理完毕
  • 最终的buildFileTree函数返回Promise,调用侧需要通过await拿到最终结果

重构后的参考实现

// 单个文件条目转Promise,解决回调嵌套
function getFileEntryMeta(fileEntry) {
  return new Promise((resolve) => {
    fileEntry.file(file => {
      resolve({
        id: uuidv4(),
        name: fileEntry.name,
        parent_id: null,
        file: fileEntry
      })
    })
  })
}

// 读取目录下全量条目,解决readEntries单次返回上限的问题
function readAllDirEntries(dirReader) {
  return new Promise((resolve) => {
    let allEntries = []
    function readBatch() {
      dirReader.readEntries(entries => {
        if (!entries.length) {
          resolve(allEntries)
          return
        }
        allEntries = allEntries.concat(entries)
        readBatch()
      })
    }
    readBatch()
  })
}

// 递归遍历逻辑改造为async
async function traverseFileTree(fileTree, parentPath, entry) {
  const parentNode = parentPath ? fileTree[parentPath] : null
  const parentId = parentNode?.id ?? null

  if (entry.isFile) {
    const fileMeta = await getFileEntryMeta(entry)
    fileMeta.parent_id = parentId
    fileTree[entry.fullPath] = fileMeta
    return
  }

  if (entry.isDirectory) {
    // 先写入当前目录的元信息
    fileTree[entry.fullPath] = {
      id: uuidv4(),
      name: entry.name,
      is_directory: true,
      parent_id: parentId,
      file: null
    }
    // 读取当前目录下所有子条目,等待全部子条目遍历完成
    const childEntries = await readAllDirEntries(entry.createReader())
    await Promise.all(
      childEntries.map(child => traverseFileTree(fileTree, entry.fullPath, child))
    )
  }
}

// 构建函数改造为async,等所有顶层条目遍历完成再返回结果
export async function buildFileTree(allEntries) {
  const fileTree = {}
  await Promise.all(
    allEntries.map(entry => traverseFileTree(fileTree, null, entry))
  )
  return fileTree
}

调用侧的适配修改

const handleUploadDrop = async (files) => {
  // 等待所有异步流程完成,拿到构建完成的文件树
  const finalFiles = await buildFileTree(files)

  // 此时执行序列化、遍历、长度获取均可拿到正确结果
  console.log(finalFiles)
  console.log(JSON.stringify(finalFiles))
  console.log(Object.keys(finalFiles).length)
}

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.29 10:27:04