Flutter Firebase问题：无法将图片URL写入Firestore子集合

我正在实现用户上传图片至Firebase的功能，图片已成功存储到Firebase Storage，但无法将图片的下载URL写入Firestore的指定位置——users集合下的Documents子集合（字段名为Document），该字段始终显示为空字符串。

核心问题点 #

• 异步操作未同步执行：uploadImage和documentID都是异步操作，点击按钮时直接连续调用，documentID会在uploadImage还没完成赋值imageUrl时就执行，导致写入空字符串。
• 获取下载URL未等待异步结果：refImageUpload.getDownloadURL()是异步方法，直接调用.toString()得到的是Future对象的字符串，而非实际的下载URL。
• Firestore写入未等待完成：documentID中调用add方法未使用await，可能导致写入失败无反馈。

修正后的完整代码 #

class _ImageVerificationScreenState extends State<ImageVerificationScreen> {
  File? image;
  String? imageUrl = '';

  Future<File> customCompressed({
    required File imagePathToCompress,
    int quality = 100,
    int percentage = 10,
  }) async {
    var path = await FlutterNativeImage.compressImage(
      imagePathToCompress.absolute.path,
      quality: 100,
      percentage: 80,
    );
    return path;
  }

  Future<File?> pickImages(BuildContext context) async {
    File? image;
    try {
      final pickedImage = await ImagePicker().pickImage(source: ImageSource.camera);
      if (pickedImage != null) {
        image = File(pickedImage.path);
        File compressedImage = await customCompressed(imagePathToCompress: image);
        setState(() {
          image = compressedImage;
        });
      }
    } catch (e) {
      showSnackBar(context, e.toString());
    }
    return image;
  }

  // 修改为Future方法，以便外部可以await
  Future<void> uploadImage() async {
    if (image == null) return;
    String uid = FirebaseAuth.instance.currentUser!.uid;
    Reference ref = FirebaseStorage.instance.ref();
    Reference refDirImage = ref.child('Documents');
    Reference refImageUpload = refDirImage.child(uid);
    try {
      await refImageUpload.putFile(image!);
      // 等待异步获取下载URL
      imageUrl = await refImageUpload.getDownloadURL();
    } catch (error) {
      showSnackBar(context, error.toString());
    }
  }

  Future<String?> documentID() async {
    if (imageUrl == null || imageUrl!.isEmpty) return null;
    String uid = FirebaseAuth.instance.currentUser!.uid;
    CollectionReference documentCollection = FirebaseFirestore.instance
        .collection('users')
        .doc(uid)
        .collection('Documents');
    // 等待文档添加完成
    await documentCollection.add({'Document': imageUrl});
    return imageUrl;
  }

  void selectImage() async {
    image = await pickImages(context);
  }

  @override
  Widget build(BuildContext context) {
    final screenHeight = MediaQuery.of(context).size.height;
    final screenWidth = MediaQuery.of(context).size.width;
    return SafeArea(
      child: Scaffold(
        // 省略UI部分
        body: Center(
          child: TextButton(
            onPressed: () async {
              // 先等待上传完成，再写入Firestore
              await uploadImage();
              await documentID();
            },
            child: const Text(
              'Upload document',
              style: TextStyle(fontSize: 20, fontWeight: FontWeight.bold),
            ),
          ),
        ),
      ),
    );
  }
}

额外优化建议 #

• 添加空值判断：在uploadImage和documentID中先检查image和imageUrl是否为空，避免空指针异常。
• 错误反馈：在documentID中添加异常捕获，将错误信息通过SnackBar展示，方便调试。

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