如何使用Supabase JS Client仅重命名文件夹？

结论：目前没有原生方法可以直接重命名Supabase Storage中的文件夹，你必须更新该文件夹下所有文件的路径前缀才能实现"重命名文件夹"的效果。

为什么直接调用move无效？ #

Supabase Storage底层是对象存储服务，和S3类似——这里的"文件夹"并不是真实的实体，只是文件路径中的前缀。比如parent/file.txt里的parent/只是路径的一部分，不存在单独的parent文件夹对象。所以直接给move方法传入文件夹路径，它找不到对应的文件实体，自然不会生效。

你尝试的这段代码确实无法完成文件夹重命名：

await supabase.storage.from("bucket_id").move(oldFolderName, newFolderName)

高效实现文件夹重命名的方案 #

虽然没有原生方法，但可以通过批量修改文件路径来实现，这里提供一个简洁的处理函数：

async function renameFolder(bucket, oldFolderPrefix, newFolderPrefix) {
  // 递归列出目标文件夹下的所有文件（含子目录）
  const { data: items, error } = await bucket.list(oldFolderPrefix, { recursive: true });
  
  if (error) throw error;

  // 批量生成移动任务
  const moveTasks = items
    .filter(item => item.name) // 只处理文件（过滤目录占位符）
    .map(item => {
      const newFilePath = item.name.replace(oldFolderPrefix, newFolderPrefix);
      return bucket.move(item.name, newFilePath);
    });

  // 并行执行所有移动操作
  await Promise.all(moveTasks);
}

// 使用示例：把"parent/"重命名为"super_parent/"
const targetBucket = supabase.storage.from("bucket_id");
await renameFolder(targetBucket, "parent/", "super_parent/");

注意事项 #

• 路径前缀要带上末尾的斜杠/，避免误匹配到文件名包含该前缀的文件（比如防止把parent-file.txt改成super_parent-file.txt）
• 开启recursive: true可以一次性获取所有层级的文件，不用手动写多层递归遍历
• 用Promise.all并行处理移动请求，比串行执行效率高很多

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