Flutter集成Firebase后获取用户名称返回Null问题排查

常见原因及修复步骤 #

1. 确认Firestore数据结构与字段名 #

• 检查Firebase控制台中users集合下的用户文档：
  • 文档ID必须与用户的uid完全一致（和注册时存入的ID匹配）
  • 字段名必须是**name**（Firestore字段名区分大小写，Name或username这类变体都会导致获取失败）
• 确保文档中确实存在name字段且有有效值。

2. 修复getData方法：添加状态更新 #

你的getData是异步方法，获取到_name后没有调用setState，导致UI不会刷新，即使拿到数据也显示为Null。修改后的代码：

void getData() async{
  User? user = _auth.currentUser;
  if(user == null) return; // 增加空判断，避免空指针异常
  _uid = user.uid;
  final DocumentSnapshot userDoc = await FirebaseFirestore.instance.collection('users').doc(user.uid).get();

  if(userDoc.exists){ // 先判断文档是否存在
    setState(() {
      _name = userDoc.get('name');
    });
  } else {
    // 处理文档不存在的场景，比如设置默认值
    setState(() {
      _name = "未设置昵称";
    });
  }
}

3. 可选：使用实时监听同步数据 #

如果需要实时同步用户数据（比如用户修改名称后自动更新UI），可以用stream监听文档变化：

@override
void initState() {
  super.initState();
  _scrollcontroller = ScrollController();
  _scrollcontroller?.addListener(() {
    setState(() {});
  });
  // 替换getData为实时监听
  listenToUserData();
}

void listenToUserData(){
  User? user = _auth.currentUser;
  if(user == null) return;
  FirebaseFirestore.instance.collection('users').doc(user.uid)
    .snapshots()
    .listen((DocumentSnapshot snapshot) {
      if(snapshot.exists){
        setState(() {
          _name = snapshot.get('name');
          _uid = user.uid;
        });
      }
    });
}

4. 校验注册时的写入逻辑 #

确保注册代码确实将name正确写入Firestore，示例代码如下：

Future<void> registerUser(String email, String password, String name) async {
  UserCredential credential = await _auth.createUserWithEmailAndPassword(
    email: email,
    password: password,
  );
  User? user = credential.user;
  if(user != null){
    await FirebaseFirestore.instance.collection('users').doc(user.uid).set({
      'name': name,
      'uid': user.uid,
      'email': email,
    });
  }
}

• 确认set方法中的字段名是name，与获取时的字段名完全一致。

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