Flutter/Dart中Firebase Storage的.putFile()执行阻塞问题求助

问题描述 #

各位好：
我在使用Firebase Storage的.putFile()方法时，图片已成功保存到存储中，但该方法始终无法resolve，导致后续代码从未执行。请问该如何解决？

【更新】
大家好，我通过延迟调用uploadImageToFirebase()所在的函数解决了问题，这给了它足够的执行时间。感谢各位的回复！

相关代码 #

Future<String> uploadImageToFirebase(File image) async {
     if (image == null) { return ""; }

     final Reference firebaseStorageRef = FirebaseStorage.instance.ref();

     final Reference referenceOfUsersImages =
        firebaseStorageRef.child('profilePictures');

     String uniqueFileName = DateTime.now().millisecondsSinceEpoch.toString();

     final Reference referenceOfUserImage =
        referenceOfUsersImages.child(uniqueFileName);

    try {
      referenceOfUserImage.putFile(image);

      String url = await referenceOfUserImage.getDownloadURL();

      return url;
    } catch (err) {
      print(err);
      return '';
    }
}

问题分析与解决方案 #

你的代码存在核心问题：调用putFile时未使用await。putFile是异步方法，返回UploadTask对象，若不等待它执行完成就直接调用getDownloadURL，会导致逻辑执行顺序混乱：

• 即使文件最终能上传成功，getDownloadURL可能在上传未完成时就触发，要么报错，要么被迫等待上传结束，但代码未显式等待putFile，就会表现出“无法resolve”的现象。
• 你用延迟调用函数的方式能临时解决问题，本质是给后台上传任务留足了执行时间，但这不是根本解法，显式控制异步流程才是可靠方案。

正确写法是给putFile加上await，确保上传完成后再获取下载链接：

Future<String> uploadImageToFirebase(File image) async {
     if (image == null) { return ""; }

     final Reference firebaseStorageRef = FirebaseStorage.instance.ref();

     final Reference referenceOfUsersImages =
        firebaseStorageRef.child('profilePictures');

     String uniqueFileName = DateTime.now().millisecondsSinceEpoch.toString();

     final Reference referenceOfUserImage =
        referenceOfUsersImages.child(uniqueFileName);

    try {
      // 加上await，等待上传任务完成
      await referenceOfUserImage.putFile(image);

      String url = await referenceOfUserImage.getDownloadURL();

      return url;
    } catch (err) {
      print(err);
      return '';
    }
}

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