如何批量获取Firebase Storage指定文件夹内的文件下载URL

核心结论 #

Firebase Storage 官方暂未提供公开的批量获取多个文件下载URL的API，你当前遇到的多文件逐个请求耗时高是标准实现的固有问题，有两种常用的优化方案可选：

方案1：提前将下载URL存入Firebase Firestore（生产环境首推） #

这是绝大多数生产场景的最优解，操作逻辑如下：

• 每次上传文件到Storage成功后，同步将该文件的下载URL、所属目录、文件名、上传时间等元数据写入Firestore对应集合，比如你可以建立group_files集合，单个文档对应一个Storage文件，预留download_url、storage_path等字段存储对应信息
• 后续需要拉取groups目录下所有文件的URL时，仅需要发起一次Firestore的条件查询即可批量拿到所有URL，耗时远低于多次调用Storage接口
• 额外收益是可基于Firestore的查询能力实现文件筛选、排序、分页等扩展功能，不需要额外开发
• 注意要在文件删除、覆盖更新时同步修改Firestore中的对应数据，避免返回无效链接

方案2：优化现有异步逻辑，并行发起请求 #

如果不想额外维护数据库中的URL数据，可以直接修改现有代码的串行请求逻辑为并行请求，大幅降低耗时：
原代码的for循环是串行等待每个getDownloadURL请求完成后再发起下一个，改成Dart的Future.wait并行发起所有请求即可：

List<String> URLs = [];
final ListResult _files = await _fireStorage.ref('groups/').list();

// 并行生成所有下载URL的Future
final urlFutureList = _files.items.map((fileRef) => fileRef.getDownloadURL());
// 等待所有并行请求完成
URLs = await Future.wait(urlFutureList);

• 优化后耗时会从「单次请求耗时 * 文件数量」降低到接近单次请求的耗时
• 如果文件数量超过100个，建议做分批并行处理，避免触发Firebase的请求限流

特殊场景补充：公开读权限文件可本地拼接URL #

如果你的groups目录下的所有文件都配置了公开读权限，不需要鉴权即可访问，可以直接按照固定格式本地拼接下载URL，完全不需要调用Storage接口：
https://firebasestorage.googleapis.com/v0/b/<你的Storage桶名>/o/<URL编码后的文件路径>?alt=media
该方法仅适用于公开权限文件，私有文件的下载URL包含时效性鉴权token，无法手动拼接

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