如何在云存储中复制整个存储文件夹至新路径？

当然可以实现批量复制文件夹下的所有文件，不需要逐个指定文件名。Google Cloud Storage（Firebase Storage基于它构建）里并没有真正的文件夹结构，所有文件都是通过路径前缀来模拟层级的，所以我们可以通过列出指定前缀下的所有文件，再批量复制到目标路径。

实现代码 #

const updateStorageData = async (docId, userId) => {
  const bucket = admin.storage().bucket();
  const sourcePrefix = `documents/${docId}/`;
  // 获取指定前缀下的所有文件
  const [files] = await bucket.getFiles({ 
    prefix: sourcePrefix,
    delimiter: '/' // 排除子文件夹的占位符文件
  });

  // 并行处理所有文件的复制
  const copyTasks = files.map(async (sourceFile) => {
    // 构造目标文件路径：替换原路径前缀
    const targetPath = sourceFile.name.replace(sourcePrefix, `users/${userId}/documents/${docId}/`);
    const targetFile = bucket.file(targetPath);
    
    // 执行复制，可添加overwrite选项控制是否覆盖已存在文件
    await sourceFile.copy(targetFile, { overwrite: true });
    console.log(`完成复制: ${sourceFile.name} → ${targetPath}`);
  });

  // 等待所有复制任务完成
  await Promise.all(copyTasks);
  console.log("文件夹下所有文件复制完成");
};

// 调用示例：复制documents/1下的所有文件到users/testID/documents/1
updateStorageData('1', 'testID');

关键说明 #

• bucket.getFiles({ prefix: sourcePrefix, delimiter: '/' })：通过前缀筛选出目标文件夹下的所有文件，delimiter: '/'可以过滤掉GCS中用来模拟文件夹的空占位符文件，只获取实际的文件。
• 路径替换逻辑：直接将原文件路径的前缀替换为目标路径前缀，保证文件结构完全一致。
• 并行复制：用Promise.all同时处理多个文件复制，比逐个串行复制效率更高。

注意事项 #

• 确保你的服务账号拥有storage.objects.get（读取源文件）和storage.objects.create（写入目标文件）的权限。
• 如果需要避免覆盖目标路径已存在的文件，可将copy方法的overwrite参数设为false，此时若目标文件已存在会抛出错误，你可以根据需求添加错误处理逻辑。
• 如果文件夹下文件数量极多（超过1000个），getFiles会自动分页返回结果，默认autoPaginate: true会自动处理分页，无需额外操作。

内容的提问来源于stack exchange，提问作者Mark James