Firebase Storage文件上传失败时的错误捕获问题

首先直接回应你的核心疑问：Firebase Storage 默认不会自动帮你缓存离线上传任务，也不会在APP重启后自动恢复未完成的上传。它的重试机制仅在当前APP会话内，针对网络波动做有限次数的重试，一旦重试耗尽或APP重启，未完成的上传就会丢失，所以你需要自行实现离线缓存和后续重传的逻辑。

接下来聊聊你遇到的错误捕获问题：

为什么控制台有错误但代码没捕获？ #

你看到的E/StorageException(13068): The operation retry limit has been exceeded.是Firebase底层打印的错误，但StorageUploadTask.future并没有将这个错误正确抛给你的代码。这是因为StorageUploadTask本质是一个Stream，它会持续发出任务状态变化，单纯依赖future有时无法及时捕获错误状态。

正确的错误捕获方式 #

你应该监听上传任务的状态变化，而不是只等待future完成。示例代码如下：

final StorageUploadTask uploadTask = ref.putFile(image, const StorageMetadata(contentLanguage: "en"));

uploadTask.listen((StorageTaskSnapshot snapshot) {
  switch (snapshot.state) {
    case StorageTaskState.running:
      // 上传中，可处理进度更新逻辑
      break;
    case StorageTaskState.success:
      // 上传成功，获取下载链接
      final downloadUrl = snapshot.downloadUrl;
      print(downloadUrl);
      break;
    case StorageTaskState.failed:
      // 捕获上传失败错误
      final error = snapshot.error;
      print("上传失败: $error");
      // 这里可以触发离线缓存逻辑，把文件信息存到本地
      break;
    case StorageTaskState.paused:
      // 上传暂停，可处理暂停相关逻辑
      break;
  }
});

实现离线上传的思路 #

当检测到上传失败（比如无网络导致重试耗尽），你需要：

• 将待上传的文件路径、Firebase存储目标路径、文件元数据等信息，存储到本地持久化存储（比如Hive、SharedPreferences或者SQLite）
• 监听网络状态变化（可以用connectivity_plus这类包），当网络恢复时，遍历本地存储的待上传任务，重新发起putFile请求
• 上传成功后，从本地存储中移除对应的任务记录

关于重试时间的设置 #

你设置的setMaxUploadRetryTimeMillis(10)是指整个上传任务的重试总时长，不是单次重试的间隔。如果网络完全断开，Firebase会在这个时长内尝试重试，超过后才会标记任务失败。

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