Flutter Firestore如何查询统计同一集合内的新增文档数量

原有代码问题说明 #

你之前的实现错误点在于误用了newIndex属性，该属性仅代表当前文档在本次快照返回的文档列表中的排序位置，和是否为新增文档没有对应关系，遍历赋值时会被后续变更的索引覆盖，自然无法得到正确的新增计数。

推荐方案1：基于时间戳的条件查询（最稳定） #

该方案适合按时间范围统计新增文档的场景，不受监听状态、App重启的影响，准确率最高。

1. 首先在新增文档时统一写入服务器时间字段，避免本地时间偏差：

// 新增文档时添加createTime字段
FirebaseFirestore.instance.collection(widget.documentUid).add({
  // 你的业务字段
  "createTime": FieldValue.serverTimestamp(),
});

2. 统计时按时间范围过滤查询，直接获取符合条件的文档数量：

// 示例：统计今日0点至今的新增文档数
DateTime now = DateTime.now();
DateTime startTime = DateTime(now.year, now.month, now.day);
// 如果要统计最近24小时的新增，可替换为 DateTime startTime = now.subtract(Duration(hours: 24));

QuerySnapshot querySnapshot = await FirebaseFirestore.instance
    .collection(widget.documentUid)
    .where("createTime", isGreaterThan: startTime)
    .get();

// 直接获取符合条件的新增文档数量
int newCount = querySnapshot.size;

// 更新到你的countM字段
await FirebaseFirestore.instance
    .collection(widget.documentUid)
    .doc(currentUser.uid)
    .update({"countM": newCount});

注意：第一次执行该查询时，Firebase会返回索引创建提示，按照提示在控制台创建createTime字段的索引即可正常使用。

方案2：基于docChanges的增量统计（仅适合实时监听场景） #

如果你需要统计从开启监听之后新增的文档数量（不区分时间，仅统计监听启动后的增量），可以使用该方案，需要过滤初始加载的存量数据：

// 标记是否为首次加载快照（首次加载的为存量数据，不计入新增）
bool isFirstLoad = true;
// 存储累计新增数量
int incrementCount = 0;

// 开启集合实时监听
FirebaseFirestore.instance
    .collection(widget.documentUid)
    .snapshots()
    .listen((snapshot) {
  if (isFirstLoad) {
    isFirstLoad = false;
    return;
  }
  // 仅统计类型为added的变更（即新增的文档）
  for (var change in snapshot.docChanges) {
    if (change.type == DocumentChangeType.added) {
      incrementCount++;
    }
  }
  // 更新计数
  FirebaseFirestore.instance
      .collection(widget.documentUid)
      .doc(currentUser.uid)
      .update({"countM": incrementCount});
});

注意：该方案的计数会在监听断开、App重启后重置，仅适合短期实时增量统计场景。

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