Firestore集合拉取用户数据时snapshot.hasData返回null问题求助

1. 核心代码错误修正 #

你的getUserByUsername方法存在不必要的Future封装，snapshots()本身会直接返回Stream对象，不需要async修饰与await调用，修正后代码如下：

DatabaseMethods类修正 #

Stream<QuerySnapshot> getUserByUsername(String username) {
    return FirebaseFirestore.instance
        .collection("users")
        .where("username", isEqualTo: username.trim())
        .snapshots();
}

搜索点击事件修正 #

onSearchBtnClick() {
    isSearching = true;
    setState(() {});
    // 无需await，直接赋值Stream即可
    usersStream = DatabaseMethods()
        .getUserByUsername(searchUsernameEditingController.text);
    setState(() {});
}

2. 补充StreamBuilder状态判断 #

原代码未处理加载、错误状态，容易误判查询结果，修正后的组件代码：

Widget searchUserList() {
  return StreamBuilder(
    stream: usersStream,
    builder: (context, AsyncSnapshot snapshot) {
      // 加载中状态
      if (snapshot.connectionState == ConnectionState.waiting) {
        return const Center(child: CircularProgressIndicator());
      }
      // 查询报错状态
      if (snapshot.hasError) {
        return Center(child: Text("查询错误：${snapshot.error.toString()}"));
      }
      // 正常数据/空数据判断
      return snapshot.hasData && snapshot.data.docs.isNotEmpty
          ? ListView.builder(
              itemCount: snapshot.data.docs.length,
              itemBuilder: (context, index) {
                DocumentSnapshot ds = snapshot.data.docs[index];
                return Image.network(ds["imgUrl"]);
              })
          : const Center(child: Text("No Users Found"));
    });
}

3. 额外排查点 #

• 确认Firestore安全规则开放了users集合的读取权限，可临时使用测试规则验证：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /users/{userId} {
      allow read: if true;
    }
  }
}

测试完成后请及时调整为符合业务安全要求的规则，避免数据泄露。

• 确认Firestore中users集合的字段名确实为username，无大小写、拼写错误，且你搜索的用户名与库中存储的值完全匹配（Firestore字符串查询默认大小写敏感，存储的ZhangSan无法匹配搜索的zhangsan）。
• 确认搜索输入的内容无多余前后空格，上述修正代码中已经加入trim()处理空格问题。

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