Flutter中从Firebase Firestore通过用户ID获取用户名无输出问题求助

下面梳理几个大概率导致问题的原因及对应解决方法：

1. 集合/字段名大小写不匹配 #

Firestore对集合、字段名的大小写严格敏感：

• 核对Firestore后台的集合名是Users还是users，代码里的集合名必须和后台完全一致
• 检查后台字段名是username还是userName，代码里的userData['username']要和后台字段名完全对应

2. 用户ID传入错误 #

确认调用getUsername时传入的userId和Firestore里的文档ID完全一致，比如你是不是用了_auth.currentUser?.uid？可以先打印传入的userId再去后台核对：

// 调用时先打印用户ID
String? userId = _auth.currentUser?.uid;
print("传入的用户ID: $userId");
var username = await getUsername(userId!);

3. Firestore权限规则限制 #

如果Firestore规则未开放读取权限，请求会被拒绝，导致快照不存在。可以先临时开放测试（上线前务必改回安全规则）：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read, write: if true;
    }
  }
}

4. 代码添加排查日志 #

给原代码补充日志，方便定位问题：

final FirebaseAuth _auth = FirebaseAuth.instance;
Future<String?> getUsername(String userId) async {
  try {
    print("尝试获取用户ID: $userId 的数据");
    DocumentSnapshot snapshot =
        await FirebaseFirestore.instance.collection('Users').doc(userId).get();

    print("快照是否存在: ${snapshot.exists}");
    if (snapshot.exists) {
      Map<String, dynamic> userData = snapshot.data() as Map<String, dynamic>;
      print("用户所有数据: $userData"); // 打印全部数据，确认是否包含username字段
      String? username = userData['username'];
      print("获取到的用户名: $username");
      return username;
    } else {
      print("该用户ID对应的文档不存在");
      return null;
    }
  } catch (e) {
    print("获取数据出错: $e"); // 捕获异常，比如权限、网络问题
    return null;
  }
}

5. 调用方法时未正确使用await #

如果调用getUsername时没加await，你拿到的会是Future<String?>而非实际用户名：

// 错误写法：
String? name = getUsername(userId); // 拿到的是Future对象
// 正确写法：
String? name = await getUsername(userId);

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