Flutter中如何通过方法获取Firestore数据，根据UID查询返回用户名？

错误原因 #

• 你声明的getUserNameFromUID是同步返回String的方法，但FirebaseFirestore.instance.get()属于异步IO操作，需要等待数据库查询完成才能拿到结果，同步方法执行时不会等异步操作结束。
• then回调内部的return doc["name"]只会把值返回给then方法本身的Future上下文，根本无法传递到外层的getUserNameFromUID方法作为返回值。
• 你在方法末尾加return "0"时，异步查询还没执行完，方法就已经同步返回了默认值，自然拿不到正确的用户名。
• 额外说明：Firestore不存在直接同步返回String的方法，所有数据库读写、网络请求类IO操作都是异步设计，Flutter也禁止在主线程做同步阻塞的IO操作，否则会直接导致UI卡顿、应用无响应。

解决办法（无需使用FutureBuilder） #

你可以在拿到异步查询结果后主动更新UI状态即可，不需要依赖FutureBuilder，实现代码如下：

1. 修改查询方法为异步，返回Future #

Future<String> getUserNameFromUID(String uid) async {
  // 用await等待异步查询执行完成
  final querySnapshot = await FirebaseFirestore.instance
      .collection('users')
      .where('uid', isEqualTo: uid)
      .get();
  // 查到对应数据就返回用户名
  if (querySnapshot.docs.isNotEmpty) {
    return querySnapshot.docs.first["name"] as String;
  }
  // 未查到数据返回默认值
  return "0";
}

2. 调用查询方法，拿到结果后更新UI #

以StatefulWidget为例，你可以定义变量存储用户名，拿到结果后调用setState更新UI即可：

// 定义类变量存储用户名，初始可以设为加载提示
String _userName = "加载中...";

@override
void initState() {
  super.initState();
  // 页面初始化时触发用户名查询
  _loadUserName();
}

// 异步加载用户名的逻辑
void _loadUserName() async {
  String targetUid = "传入你要查询的用户UID";
  String finalName = await getUserNameFromUID(targetUid);
  // 拿到结果后刷新UI
  setState(() {
    _userName = finalName;
  });
}

@override
Widget build(BuildContext context) {
  // 构建UI时直接使用已经加载好的_userName变量即可
  return Text(_userName);
}

可选缓存方案 #

如果你的应用内频繁需要根据UID查用户名，且用户量级不大，可以提前把所有用户的UID和用户名映射关系缓存到内存中，后续查询就可以同步返回：

// 全局缓存的UID-用户名映射表
Map<String, String> _uidToNameCache = {};

// 应用初始化时预加载所有用户数据
Future<void> preloadUserCache() async {
  final querySnapshot = await FirebaseFirestore.instance.collection('users').get();
  for (var doc in querySnapshot.docs) {
    _uidToNameCache[doc["uid"] as String] = doc["name"] as String;
  }
}

// 后续查询可以直接同步返回
String getUserNameFromUID(String uid) {
  return _uidToNameCache[uid] ?? "0";
}

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