如何使用Dart在Flutter项目中统计Firebase Firestore集合的文档数量

以下是三种适配不同场景的实现方案：

1. 小集合临时统计方案 #

适合文档量小于1000的测试/轻量场景，直接拉取全量文档快照获取数量：

import 'package:cloud_firestore/cloud_firestore.dart';

// 统计TestUsers集合文档总数
Future<int> countTestUsersDocs() async {
  final testUsersRef = FirebaseFirestore.instance.collection('TestUsers');
  final snapshot = await testUsersRef.get();
  return snapshot.size;
}

注意：该方案会消耗和集合文档数相等的读配额，文档量较大时不建议使用

2. 全场景通用聚合查询方案 #

Firestore 官方提供了专用的count()聚合查询接口，无论集合文档量多大，每次查询仅消耗1次读配额，是生产环境的首选方案：

import 'package:cloud_firestore/cloud_firestore.dart';

// 统计TestUsers集合文档总数
Future<int> countTestUsersDocs() async {
  final testUsersRef = FirebaseFirestore.instance.collection('TestUsers');
  final countResult = await testUsersRef.count().get();
  return countResult.count ?? 0;
}

调用上述方法即可拿到你预期的TestUsers集合数量3。

3. 高并发查询场景优化方案 #

如果该计数接口需要被高频调用（比如每秒查询次数超过100），建议用分布式计数器方案进一步优化成本和响应速度：

• 新建专门存储计数器的集合，比如GlobalCounters，新增文档test_users_count，内置value字段存储当前总数
• 配置Firebase云函数，监听TestUsers集合的创建、删除事件，触发时自动更新test_users_count文档的value值
• 查询总数时直接读取test_users_count文档的value字段即可，仅消耗1次读配额，响应速度远快于聚合查询

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