为什么Flutter的StreamBuilder查询Firestore时添加orderBy会触发错误

问题原因 #

你遇到的报错是Firestore复合索引要求导致的：单独使用where条件过滤或者单独使用orderBy排序时不需要额外配置，但二者组合使用时，Firestore必须依赖专属复合索引才能高效返回查询结果，这是Firestore的内置性能限制规则，也是你添加orderBy子句后才出现报错的核心原因。

解决步骤 #

• 打开运行日志，找到Firestore抛出的完整错误信息，错误内容中会自动生成对应复合索引的创建地址，将地址复制到浏览器打开，进入Firebase控制台直接确认创建即可，系统会自动配置好索引的字段、排序规则等参数，无需手动调整。
• 等待索引创建完成，通常耗时1到5分钟，取决于你当前数据集的大小，索引状态更新为已启用后，重新运行项目即可正常拉取排序后的数据流。
• 如果后续调整了查询规则，比如新增过滤条件、更换排序字段，都需要重新创建对应的复合索引。
• 针对你的通知类使用场景，建议可以将排序方向改为倒序：orderBy('timestamp', descending: true)，这样最新生成的通知会排在列表最前面，更符合常规使用习惯。

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