Flutter中Firestore按date排序后返回空列表的问题

问题原因 #

你的查询同时使用了where过滤（userId和date）和orderBy排序（date），Firestore要求这种组合查询必须创建复合索引才能返回结果，缺少索引时会直接返回空列表。另外，当前代码的错误处理存在遗漏，无法直观看到查询报错信息。

解决步骤 #

1. 查看Firebase控制台错误日志
   运行带orderBy的查询后，打开Firebase控制台的「Firestore数据库」→「监控」→「日志」，会看到一条关于缺少索引的错误信息，里面包含直接创建索引的链接，点击即可自动生成所需的复合索引。

2. 调整查询顺序（最佳实践）
   将where过滤子句放在orderBy之前，代码逻辑更清晰，也符合Firestore查询优化原则：

   static Stream<QuerySnapshot<TaskModel>> getTasks(DateTime date) {
     return getTasksCollection()
         .where("userId", isEqualTo: FirebaseAuth.instance.currentUser?.uid)
         .where("date", isEqualTo: DateUtils.dateOnly(date).millisecondsSinceEpoch)
         .orderBy('date', descending: true)
         .snapshots();
   }
   

3. 修复错误处理逻辑
   当前StreamBuilder中遇到错误时未返回组件，导致无法感知查询错误，补充return语句：

   if (snapshot.hasError) {
     return const Center(child: Text("something went wrong"));
   }
   

4. 等待索引生效
   索引创建完成需要几分钟时间，等待后重新运行应用，数据即可正常加载并按date降序排序。

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