Flutter集成Firebase多分类查询：获取含目标分类的对象方案

方案1：利用array-contains-any（适用于目标分类≤10个的场景） #

Firestore的array-contains-any操作符可直接查询数组字段包含指定集合中任意元素的文档，完全匹配你的需求。如果目标分类数组长度不超过10，直接用这个方法即可。

示例代码：

// Firebase Firestore 实例
final firestore = FirebaseFirestore.instance;

// 目标分类数组（长度≤10）
List<String> targetCategories = ["分类A", "分类B", "分类C"];

// 查询至少包含一个目标分类的文档
QuerySnapshot snapshot = await firestore.collection("your_collection")
  .where("categories", arrayContainsAny: targetCategories)
  .get();

// 处理查询结果
snapshot.docs.forEach((doc) {
  print(doc.data());
});

方案2：拆分查询+合并结果（目标分类>10个的场景） #

如果目标分类超过10个，把数组拆分成多个长度≤10的子数组，分别执行array-contains-any查询，最后在客户端合并去重结果。

示例代码：

// 拆分目标分类数组为多个子数组，每个子数组长度不超过10
List<List<String>> splitCategories(List<String> categories) {
  List<List<String>> chunks = [];
  for (var i = 0; i < categories.length; i += 10) {
    chunks.add(categories.sublist(i, i + 10 > categories.length ? categories.length : i + 10));
  }
  return chunks;
}

// 执行多查询并合并结果
Future<List<DocumentSnapshot>> getFilteredDocs() async {
  final firestore = FirebaseFirestore.instance;
  // 模拟15个目标分类
  List<String> targetCategories = List.generate(15, (index) => "分类$index"); 
  var chunks = splitCategories(targetCategories);
  
  List<QuerySnapshot> snapshots = [];
  for (var chunk in chunks) {
    var snap = await firestore.collection("your_collection")
      .where("categories", arrayContainsAny: chunk)
      .get();
    snapshots.add(snap);
  }
  
  // 按文档ID去重并合并
  Map<String, DocumentSnapshot> uniqueDocs = {};
  for (var snap in snapshots) {
    for (var doc in snap.docs) {
      uniqueDocs[doc.id] = doc;
    }
  }
  
  return uniqueDocs.values.toList();
}

方案3：预处理数据（高性能推荐，适合频繁查询场景） #

如果分类查询很频繁，建议提前在Firestore文档中为每个分类添加布尔标识（或用Map存储），比如新增categoryFlags字段：

{
  "categories": ["分类A", "分类B"],
  "categoryFlags": {
    "分类A": true,
    "分类B": true,
    "分类C": false
  }
}

查询时用where结合or操作符匹配分类标识为true的文档，超过10个分类时同样拆分查询条件。

示例代码：

final firestore = FirebaseFirestore.instance;
List<String> targetCategories = ["分类A", "分类B", "分类C"];

// 构建OR查询条件
List<Filter> filters = targetCategories.map((cat) => Filter.equalTo("categoryFlags.$cat", true)).toList();

// 拆分条件为多个OR查询（每个OR最多10个条件）
List<List<Filter>> filterChunks = [];
for (var i = 0; i < filters.length; i += 10) {
  filterChunks.add(filters.sublist(i, i + 10 > filters.length ? filters.length : i + 10));
}

// 执行查询并合并去重
List<DocumentSnapshot> uniqueResults = [];
for (var chunk in filterChunks) {
  var query = firestore.collection("your_collection").where(Filter.or(chunk));
  var snap = await query.get();
  uniqueResults.addAll(snap.docs);
}
uniqueResults = uniqueResults.toSet().toList();

注意：需要为每个categoryFlags.xxx字段创建复合索引，Firebase控制台会自动提示创建索引的链接。

方案4：客户端筛选（适合数据量小的场景） #

如果集合数据量不大，可先获取所有文档，再在客户端筛选出符合条件的结果。这种方法简单，但数据量大时会占用较多带宽和客户端资源。

示例代码：

final firestore = FirebaseFirestore.instance;
List<String> targetCategories = ["分类A", "分类B", "分类C"];

// 获取所有文档
QuerySnapshot allDocs = await firestore.collection("your_collection").get();

// 客户端筛选出至少包含一个目标分类的文档
List<DocumentSnapshot> filteredDocs = allDocs.docs.where((doc) {
  List<String> docCategories = List.from(doc["categories"]);
  return docCategories.any((cat) => targetCategories.contains(cat));
}).toList();

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