Flutter接入Firestore后读取用户displayName报空调用错误如何解决？

1. 核心错误点 #

• 集合名大小写不匹配：Firestore 集合名大小写敏感，后端写入时用的集合名是Users（大写U开头），前端读取时写的是users（小写u开头），直接找不到对应文档
• 文档ID写死错误：前端doc('uid')传的是固定字符串"uid"，没有读取当前登录用户的真实uid，无法匹配到对应用户的文档
• 数据读取逻辑错误：snapshot.data是DocumentSnapshot?可空类型，没有先调用.data()方法获取文档内容就直接用[]取值，触发空安全报错

2. 修复后的前端代码 #

// 先获取当前登录用户的真实uid
final String? currentUid = FirebaseAuth.instance.currentUser?.uid;

FutureBuilder(
  // 修正集合名大小写 + 传入真实uid，uid为空时终止请求
  future: currentUid == null 
    ? null 
    : FirebaseFirestore.instance
        .collection('Users')
        .doc(currentUid)
        .get(),
  builder: (context, snapshot) {
    if (snapshot.connectionState == ConnectionState.waiting) {
      return const Text("Loading...");
    }
    if (snapshot.hasError) {
      return const Text("加载用户信息失败");
    }
    if (!snapshot.hasData || !(snapshot.data as DocumentSnapshot).exists) {
      return const Text("未找到用户信息");
    }
    // 取出文档数据转成Map后再取值
    final userData = (snapshot.data as DocumentSnapshot).data() as Map<String, dynamic>;
    return Text(userData['displayName'] ?? '匿名用户');
  }
)

3. 可选优化点 #

可以给后端写入方法补充空安全校验，避免currentUser为空时崩溃：

import 'package:cloud_firestore/cloud_firestore.dart';
import 'package:firebase_auth/firebase_auth.dart';

Future<String?> userSetup(String displayName) async {
  CollectionReference users = FirebaseFirestore.instance.collection('Users');
  User? currentUser = FirebaseAuth.instance.currentUser;
  if (currentUser == null) return null;
  String uid = currentUser.uid;
  await users.doc(uid).set({'displayName': displayName, 'uid': uid });
  final result = await users.doc(uid).get();
  final data = result.data() as Map<String, dynamic>;
  return data['displayName'];
}

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