如何通过文档ID访问Cloud Firestore文档字段？遇字段不存在错误

错误原因拆解 #

你的代码存在几个核心问题：

1. 空安全语法错误：value.data() ? ["uname"]写法错误，正确的空安全访问应该是value.data()?["uname"]，用?安全访问可空的data()返回值。
2. 异步操作处理失当：直接在类成员变量里执行Firestore的异步get()请求，既无法管控生命周期，也没法在UI中正常展示数据。
3. UI代码无效：Text(())是错误写法，没有传递有效文本内容。
4. 边界情况未处理：未判断文档是否存在，也没处理字段不存在的场景（注意Firestore字段名区分大小写，需确认文档里确实有uname字段）。

修正后代码示例 #

用FutureBuilder正确处理异步数据获取，同时完善错误逻辑：

class Test extends StatefulWidget {
  const Test({Key? key}) : super(key: key);
  
  @override
  _TestState createState() => _TestState();
}

class _TestState extends State<Test> {
  // 封装获取用户名的异步方法
  Future<String?> getUserUname() async {
    final currentUser = FirebaseAuth.instance.currentUser;
    if (currentUser == null) return null;
    
    final docSnapshot = await FirebaseFirestore.instance
        .collection("Users")
        .doc(currentUser.uid)
        .get();
    
    // 先判断文档是否存在
    if (!docSnapshot.exists) {
      print("用户文档不存在");
      return null;
    }
    
    // 安全获取uname字段，处理字段不存在的情况
    final uname = docSnapshot.data()?["uname"];
    if (uname == null) {
      print("文档中无uname字段");
      return null;
    }
    
    return uname.toString();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: FutureBuilder<String?>(
        future: getUserUname(),
        builder: (context, snapshot) {
          // 加载中状态
          if (snapshot.connectionState == ConnectionState.waiting) {
            return const Center(child: CircularProgressIndicator());
          }
          
          // 错误状态
          if (snapshot.hasError) {
            return Center(child: Text("加载失败: ${snapshot.error}"));
          }
          
          // 数据为空状态
          final uname = snapshot.data;
          if (uname == null) {
            return const Center(child: Text("未获取到用户名"));
          }
          
          // 正常展示用户名
          return Center(child: Text("用户名: $uname"));
        },
      ),
    );
  }
}

额外检查项 #

• 确认Firestore控制台中，Users集合下以用户UID为ID的文档确实存在，且包含小写uname字段（Firestore字段名区分大小写）。
• 确保Firebase权限规则允许当前用户访问自己的文档，示例基础规则：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /Users/{userId} {
      allow read, write: if request.auth != null && request.auth.uid == userId;
    }
  }
}

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