向Firebase上传视频时遇服务不可用错误的排查求助

上传视频至Firebase Storage时收到错误：

Firebase Error uploading a video the service is currently unavailable this is most likely a transient condition and may be corrected by retrying with backoff

App认证功能正常，错误不会导致崩溃，但调试未发现明显问题，以下是针对性解决方案：

1. 实现指数退避重试机制 #

错误提示明确说明这是临时状态，需通过退避重试解决。当前代码无重试逻辑，上传失败直接触发错误提示，需给上传任务添加重试逻辑：

修改视频上传方法（同理可复用至缩略图上传）：

Future<String> _uploadVideoToStorage(String id, String videoPath, {int retryCount = 3}) async {
  Reference ref = firebaseStorage.ref().child('videos').child(id);
  File compressedFile = await _compressVideo(videoPath);
  
  for (int i = 0; i < retryCount; i++) {
    try {
      UploadTask uploadTask = ref.putFile(compressedFile);
      TaskSnapshot snap = await uploadTask;
      return await snap.ref.getDownloadURL();
    } catch (e) {
      // 仅对临时不可用错误进行重试
      if (e is FirebaseException && e.code == 'unavailable' && i < retryCount - 1) {
        // 指数退避：等待时长随重试次数递增
        await Future.delayed(Duration(seconds: (1 << i)));
        continue;
      }
      rethrow; // 非临时错误或重试耗尽，抛出原错误
    }
  }
  throw Exception('上传重试次数耗尽');
}

2. 检查Firebase Storage配置与限制 #

• 确认Storage存储空间未超出配额：在Firebase控制台查看存储使用情况
• 验证存储规则：确保认证用户拥有上传权限（即使认证正常，规则可能存在时间或其他隐性限制）
• 检查文件大小：Firebase Storage默认最大支持5GB文件，大文件需改用分块上传
• 确认区域一致性：Storage存储区域需与App配置的区域匹配，避免跨区域延迟导致临时错误

3. 优化上传流程细节 #

• 增加视频压缩有效性校验：避免压缩失败导致上传无效文件

Future<File> _compressVideo(String videoPath) async {
  final compressedVideo = await VideoCompress.compressVideo(
    videoPath,
    quality: VideoQuality.MediumQuality,
  );
  if (compressedVideo?.file == null) {
    throw Exception('视频压缩失败');
  }
  return compressedVideo!.file;
}

• 替换视频ID生成逻辑：当前用集合文档数量生成ID，多用户并发上传会导致ID重复冲突，建议使用Firebase自动生成ID：

// 替换原ID生成代码
String videoId = firestore.collection('videos').doc().id;
// 后续上传和数据库存储统一使用该ID
String videoUrl = await _uploadVideoToStorage(videoId, videoPath);
String thumbnail = await _uploadImageToStorage(videoId, videoPath);

4. 监听上传任务状态（可选） #

通过监听上传任务状态，可更精准捕获错误类型并处理：

UploadTask uploadTask = ref.putFile(compressedFile);
uploadTask.snapshotEvents.listen((TaskSnapshot snapshot) {
  switch (snapshot.state) {
    case TaskState.running:
      // 可在此处更新上传进度
      break;
    case TaskState.error:
      if (snapshot.error is FirebaseException && (snapshot.error as FirebaseException).code == 'unavailable') {
        // 触发重试逻辑
      }
      break;
    default:
      break;
  }
});

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