Flutter Cloud Firestore实时更新问题：无法展示Jobs列表求助

我为代码添加了条件判断但未生效，运行时始终显示"There is no jobs"，无法展示Jobs列表。不清楚是条件判断错误还是其他问题，相关代码如下：

body: StreamBuilder<QuerySnapshot<Map<String, dynamic>>>(
  stream: FirebaseFirestore.instance
      .collection('jobs')
      .where('jobCategory', isEqualTo: jobCategoryFilter)
      .where('recruitment', isEqualTo: true)
      .orderBy('createdAt', descending: false)
      .snapshots(),
  builder: (context, AsyncSnapshot snapshot)
  {
    if(snapshot.connectionState == ConnectionState.waiting)
    {
      return const Center(child: CircularProgressIndicator(),);
    }
    else  if(snapshot.connectionState == ConnectionState.active)
    {
      if(snapshot.data.docs.length > 0){
        return ListView.builder(
            itemCount: snapshot.data?.docs.length,
            itemBuilder: (BuildContext context, int index) {
              return JobWidget(
                jobTitle: snapshot.data?.docs[index]['jobTitle'],
                jobDescription: snapshot.data?.docs[index]['jobDescription'],
                jobId: snapshot.data?.docs[index]['jobId'],
                uploadedBy: snapshot.data?.docs[index]['uploadedBy'],
                userImage: snapshot.data?.docs[index]['userImage'],
                name: snapshot.data?.docs[index]['name'],
                recruitment: snapshot.data?.docs[index]['recruitment'],
                email: snapshot.data?.docs[index]['email'],
                location: snapshot.data?.docs[index]['location'],
              );
            }
        );
      }
      else
      {
        return const Center(
          child: Text('There is no jobs'),
        );
      }
    }
    return const Center(
      child: Text(
        'Something went wrong',
        style: TextStyle(
          fontWeight: FontWeight.bold,
          fontSize: 30
        ),
      ),
    );
  }
)

排查与修复方案 #

1. 验证Firestore查询条件有效性 #

• 确认jobCategoryFilter的值与Firestorejobs集合中jobCategory字段的值完全匹配（Firestore查询是精确匹配，大小写、空格都会影响结果）。
• 检查jobs集合中是否存在recruitment字段为true的文档，且这些文档都包含createdAt字段（使用orderBy时，缺失该字段的文档会被过滤）。
• 可直接在Firebase控制台的Firestore面板执行相同查询，确认是否能返回预期文档。

2. 修复Snapshot空安全与状态判断逻辑 #

原代码存在空安全隐患，且仅判断ConnectionState.active会遗漏其他有效状态（如ConnectionState.done），改用snapshot.hasData判断数据是否存在更可靠：

body: StreamBuilder<QuerySnapshot<Map<String, dynamic>>>(
  stream: FirebaseFirestore.instance
      .collection('jobs')
      .where('jobCategory', isEqualTo: jobCategoryFilter)
      .where('recruitment', isEqualTo: true)
      .orderBy('createdAt', descending: false)
      .snapshots(),
  builder: (context, AsyncSnapshot<QuerySnapshot<Map<String, dynamic>>> snapshot) {
    // 加载中状态
    if (snapshot.connectionState == ConnectionState.waiting) {
      return const Center(child: CircularProgressIndicator());
    }

    // 错误处理
    if (snapshot.hasError) {
      return Center(child: Text('查询错误: ${snapshot.error}'));
    }

    // 无数据时提示
    if (!snapshot.hasData || snapshot.data!.docs.isEmpty) {
      return const Center(child: Text('There is no jobs'));
    }

    // 有数据时渲染列表
    return ListView.builder(
      itemCount: snapshot.data!.docs.length,
      itemBuilder: (context, index) {
        final jobDoc = snapshot.data!.docs[index];
        final jobData = jobDoc.data();
        return JobWidget(
          jobTitle: jobData['jobTitle'],
          jobDescription: jobData['jobDescription'],
          jobId: jobData['jobId'],
          uploadedBy: jobData['uploadedBy'],
          userImage: jobData['userImage'],
          name: jobData['name'],
          recruitment: jobData['recruitment'],
          email: jobData['email'],
          location: jobData['location'],
        );
      },
    );
  },
)

3. 添加复合索引（如果需要） #

如果Firebase控制台提示需要创建复合索引，按照提示完成索引创建——同时使用where和orderBy时通常需要配置复合索引才能正常查询。

内容的提问来源于stack exchange，提问作者Nguyễn Quốc Tuấn