Flutter结合Firebase Auth获取当前用户Firestore文档时读取数据返回null

错位的分支判断是导致读取结果为null的核心原因 #

你在Header组件里的FutureBuilder逻辑完全颠倒，根本没有走到“读取已检索到的文档数据”的分支：

• if (snapshot.hasData) 分支才是真正拿到了网络返回结果的场景，你在这里写了读取fullname字段的逻辑
• 打印null的代码写在了else分支——这个分支对应的是请求尚未返回、没有拿到任何快照数据的场景，此时snapshot.data本身就是null，在空对象上调用data()方法不仅永远拿不到数据，还会触发空指针异常，和Firestore文档读取失败没有关系。

除此之外还有几个容易导致取值异常的细节问题：

• 把异步请求方法直接写在build方法内的FutureBuilder参数中，每次组件重绘都会重新触发一次网络请求，容易造成状态错乱、反复加载
• 没有判断返回的文档是否真实存在，就算请求成功，如果对应uid的文档未创建，data()也会返回null
• 没有覆盖请求加载中、请求出错的场景判断，空安全环境下直接取值容易抛异常

分步修复方案 #

• 调整FutureBuilder的状态判断逻辑，按照网络请求的不同阶段分层处理：加载中显示占位组件、出错时打印错误信息、请求完成后先判断文档存在性，再读取对应字段
• 将异步请求实例提升为State类的成员变量，在initState生命周期中提前获取future对象，避免每次build都重复发起请求
• 增加空安全校验，读取字段时对可空的文档数据做非空判断，避免空指针崩溃

修复后的可运行代码 #

class _HeaderState extends State<Header> {
  // 提前存储future实例，避免build重复创建
  late Future<DocumentSnapshot> _userDocFuture;

  @override
  void initState() {
    super.initState();
    // 获取当前登录用户，初始化拉取用户文档的请求
    final currentUser = FirebaseAuth.instance.currentUser;
    if (currentUser != null) {
      _userDocFuture = _autheService.fetchCurrentUser(currentUser.uid);
    }
  }

  @override
  Widget build(BuildContext context) {
    return Container(
      child: FutureBuilder<DocumentSnapshot>(
        future: _userDocFuture,
        builder: (context, snapshot) {
          // 处理加载中状态
          if (snapshot.connectionState == ConnectionState.waiting) {
            return Text('加载中...');
          }
          // 处理请求出错状态
          if (snapshot.hasError) {
            print('用户文档读取失败: ${snapshot.error}');
            return Text('加载失败');
          }
          // 处理请求完成状态
          if (snapshot.hasData) {
            final docSnapshot = snapshot.data!;
            // 判断文档是否真实存在
            if (docSnapshot.exists) {
              // 读取字段时做空值兜底
              final docData = docSnapshot.data() as Map<String, dynamic>?;
              final fullName = docData?['fullname'] ?? '未设置用户名';
              return Row(
                children: [
                  Text(fullName),
                ],
              );
            } else {
              return Text('用户档案未创建');
            }
          }
          return Text('empty');
        },
      ),
    );
  }
}

排查补充 #

如果按照上述修复依然读不到数据，可核对两个点：

• Firestore安全规则是否允许已登录用户读取users集合下自己的文档，权限不足会导致请求被拦截，返回空结果
• 注册创建文档时，文档ID是否真的使用了firebaseAuth.currentUser.uid，集合名、文档路径有没有拼写错误

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