Flutter Firestore单文档数据获取与显示异常求助

核心问题：键名大小写不匹配 #

你存储用户数据时用的键是"Username"（首字母大写），但在FutureBuilder里获取时写的是data['username']（全小写），这直接导致无法正确取出数据，返回null。

修复步骤及代码调整 #

1. 修正FutureBuilder中的键名
   将data['username']改为data['Username']，同时添加空值处理避免异常：

FutureBuilder<DocumentSnapshot>(
  future: FirebaseFirestore.instance
      .collection("users")
      .doc(FirebaseAuth.instance.currentUser!.uid)
      .get(),
  builder: (BuildContext context, AsyncSnapshot<DocumentSnapshot> snapshot) {
    if (snapshot.hasError) {
      return Text("Something went wrong");
    }
    if (snapshot.hasData && !snapshot.data!.exists) {
      return Text("User document does not exist");
    }
    if (snapshot.connectionState == ConnectionState.done) {
      Map<String, dynamic> data = snapshot.data!.data() as Map<String, dynamic>;
      // 修正键名并添加空值默认值
      return Text("Username: ${data['Username'] ?? 'Unknown'}");
    }
    return Text("loading");
  },
),

2. 废弃initState中的手动获取逻辑
   你在initState里直接赋值username变量，但普通字符串变量不会触发Widget重建，即使拿到数据也不会更新UI。FutureBuilder本身已经能处理异步数据并自动重建，所以这部分代码可以删除。

3. 验证Firestore文档与权限

• 打开Firebase控制台，检查users集合下是否存在对应UID的文档，确认Username字段是否正确存储。
• 检查Firestore安全规则，确保已认证用户能读取自己的文档，推荐规则：

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

4. 优化注册代码的潜在问题
   你的注册代码里有一处逻辑错误：if (Validator.validateEmptyInsert('Username', username) == null || username.isEmpty) { user == null; } 这里的user == null是比较而非赋值，应该改为user = null;，否则无法正确拦截空用户名的情况。

修改后的注册逻辑片段：

if (Validator.validateEmptyInsert('Username', username) == null || username.isEmpty) {
  user = null; // 改为赋值操作
}

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