Firebase Storage上传门店Logo返回本地路径而非下载URL问题

核心问题分析 #

1. 注册方法的条件逻辑错误
   当前代码中，门店Logo的上传逻辑被嵌套在else if分支中，仅当用户头像文件不存在时才会执行。如果用户同时上传了头像和门店Logo，头像文件存在的情况下，门店Logo的上传逻辑根本不会触发，导致user.outletImage始终保留本地缓存路径，没有被替换为Firebase的下载URL。

2. uploadImageO方法的异步处理不严谨
   该方法中调用ref.whenComplete(() {})时未使用await，虽然getDownloadURL本身会等待上传完成，但这种写法不符合异步代码规范，可能引发潜在的时序问题。

修复方案 #

1. 修正注册方法的条件分支逻辑 #

将门店Logo的上传逻辑从else if中分离出来，单独判断，确保头像和门店Logo的上传逻辑互不影响：

Future<bool> register(PetUser user) async {
  final result = await firebaseAuth.createUserWithEmailAndPassword(
      email: user.email!, password: user.password!);

  firebaseMessaging.getToken().then((value) {
    debugPrint(value);
    user.token = value!;
  });

  // 单独处理用户头像上传
  if (user.imageUrl != null) {
    final file = File(user.imageUrl!);
    if (await file.exists()) {
      user.imageUrl = await uploadImage(file);
    }
  }

  // 单独处理门店Logo上传，不再与头像逻辑互斥
  if (user.outletImage != null) {
    final files = File(user.outletImage!);
    if (await files.exists()) {
      user.outletImage = await uploadImageO(files);
    }
  }

  user.id = result.user!.uid;
  await usersCollection.doc(user.id).set(user.toJson());
  await usersCollection.doc(user.id).collection('ratings').doc('1').set({
    'numberOfRates': 0,
    'rating' : 0
  });

  return true;
}

2. 修正uploadImageO方法的异步处理 #

添加await关键字，保持和uploadImage方法一致的异步处理规范：

Future<String> uploadImageO(File files) async {
  final task = storage.ref().child("outlet_images")
      .child(FirebaseAuth.instance.currentUser!.uid)
      .child(const Uuid().v4()).putFile(files);
  await task.whenComplete(() {}); // 添加await等待上传完成
  return await task.snapshot.ref.getDownloadURL();
}

额外优化建议 #

可以提取公共上传方法减少代码冗余，例如：

Future<String> uploadFile(File file, String folder) async {
  final task = storage.ref().child(folder)
      .child(FirebaseAuth.instance.currentUser!.uid)
      .child(const Uuid().v4()).putFile(file);
  await task.whenComplete(() {});
  return await task.snapshot.ref.getDownloadURL();
}

后续调用时只需传入对应参数：

user.imageUrl = await uploadFile(file, "user");
user.outletImage = await uploadFile(files, "outlet_images");

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