Flutter获取Firestore图片路径延迟致Firebase Storage加载404报错

你遇到的404 Storage对象不存在错误，完全是异步调用写法错误导致的：

1. 原GetUserModel方法只在then回调里return了文件名，没有把结果透传到方法外层，方法实际返回的是未完成的Future<dynamic>对象
2. 调用GetUserModel时没有正确等待异步结果返回，直接对Future实例调用.toString()，最终拼接到路径里的是字符串Instance of 'Future<dynamic>'，和Storage里实际的文件名不匹配，自然找不到文件
   从你贴的日志也能印证这个问题：路径拼接完成打印后，才输出真正从Firestore拿到的jpg文件名，说明异步时序完全错了。

1. 修复Firestore文件名获取方法 #

去掉冗余的then回调，明确方法返回类型，正确返回查询结果：

Future<String?> getUserProfileFileName(String? documentId) async {
  final DocumentSnapshot documentSnapshot = await FirebaseFirestore.instance
      .collection('users')
      .doc(documentId)
      .get();
  if (documentSnapshot.exists) {
    final data = documentSnapshot.data() as Map<String, dynamic>;
    final filePath = data['profileImageUrl'] as String?;
    print('Firestore返回文件名：$filePath');
    return filePath;
  }
  print('对应用户文档不存在');
  return null;
}

2. 修复Storage下载链接获取方法 #

正确等待文件名异步返回，增加空值判断，加异常捕获：

Future<String?> getUserImagePath() async {
  final user = FirebaseAuth.instance.currentUser;
  if (user == null || user.email == null) return null;
  final String userEmail = user.email!;
  final storageRef = FirebaseStorage.instance.ref();
  // 必须加await等待异步结果返回，不要提前toString
  final fileName = await getUserProfileFileName(userEmail);
  if (fileName == null || fileName.isEmpty) return null;
  final String fullPath = 'users/$userEmail/UserProfile/$fileName';
  print('最终请求的Storage路径：$fullPath');
  try {
    final downloadUrl = await storageRef.child(fullPath).getDownloadURL();
    return downloadUrl;
  } catch (e) {
    print('获取下载链接失败：$e');
    return null;
  }
}

3. 修复头像渲染组件的FutureBuilder #

调整泛型适配可空返回值，补全判断逻辑：

FutureBuilder<String?>(
  future: getUserImagePath(),
  builder: (BuildContext context, AsyncSnapshot<String?> snapshot) {
    if (snapshot.connectionState == ConnectionState.done
        && snapshot.hasData
        && snapshot.data != null) {
      return CircleAvatar(
        backgroundImage: NetworkImage(snapshot.data!),
      );
    }
    if (snapshot.hasError) {
      print('头像加载异常：${snapshot.error}');
    }
    // 加载中/无数据/出错时显示默认头像
    return Icon(
      Icons.person,
      size: (24 / 40) * widget.profileRadius * 2,
    );
  }
)

• 不要混用async/await和then时忽略返回值透传，then内部的return不会自动作为外层async方法的返回值，建议直接用await写法更不容易出错
• 所有返回Future的异步方法调用前必须加await，禁止直接对Future实例调用toString()，否则只会得到Future的类型字符串
• 尽量给所有方法明确指定返回值类型，避免用dynamic，可以在编译阶段提前发现大部分类型、异步调用错误
• 确认Firestore中存储的profileImageUrl字段值就是纯文件名（比如你日志里的Screenshot_xxx.jpg），不要带多余的路径前缀，否则拼接后的路径还是会和Storage实际路径不匹配

内容的提问来源于stack exchange，提问作者S I D D H A R D H A