Flutter中如何为Firestore StreamBuilder添加查询筛选对应user_id的待办任务

一、代码修改方案 #

你只需要在collection调用后追加where查询条件即可，修改后的代码如下，同时补充了新手容易遗漏的加载、错误状态处理：

body: StreamBuilder(
  // 新增where条件，筛选user_id等于docid的文档
  stream: FirebaseFirestore.instance.collection('todo').where('user_id', isEqualTo: docid).snapshots(),
  builder: (context, snapshot) {
    // 错误状态处理
    if (snapshot.hasError) {
      return const Center(child: Text('加载任务失败'));
    }
    // 加载中状态处理
    if (snapshot.connectionState == ConnectionState.waiting) {
      return const Center(child: CircularProgressIndicator());
    }
    // 有数据时渲染列表
    return ListView.builder(
      itemCount: snapshot.data?.docs.length ?? 0,
      itemBuilder: (context, index) {
        DocumentSnapshot course = snapshot.data!.docs[index];
        return ListTile(title: Text(course['task']));
      });
  },
)

二、索引相关说明 #

你当前使用的是单字段等值查询，Firestore默认会为所有单字段自动创建索引，不需要你手动配置，直接使用即可。
只有当你使用复合查询（比如同时筛选user_id+按isDone排序、同时筛选两个不同字段）的时候，才需要手动创建复合索引。如果后续触发了需要建索引的场景，Firestore会在控制台输出报错信息，里面直接附带了一键创建对应索引的入口，点击后等待索引创建完成即可正常使用。

三、StreamBuilder、FutureBuilder核心理解 #

你可以按以下逻辑快速区分和使用两个组件：

• FutureBuilder：用于单次异步请求的场景，比如提交表单、拉取一次用户信息，请求完成后数据不会自动更新，仅返回一次结果
• StreamBuilder：用于实时数据监听的场景，比如你的todo列表，只要Firestore里的todo数据发生变化，Stream会自动收到新数据，UI也会自动刷新，不需要手动重新拉取
  使用时的通用逻辑都是固定的：先判断错误状态、再判断加载状态、最后处理拿到数据后的UI渲染，完全可以套用上文提供的代码模板。
  Flutter官方开发文档里有这两个组件的详细示例和图解，你可以直接在Flutter官网搜索对应组件名查看，示例都是可直接运行的最小Demo，非常适合新手学习。

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