Flutter Firebase中数组逻辑AND查询的最佳实现方式

问题场景 #

需要查询Firestore中people集合里，characteristics数组同时包含brown hair和brown eyes的文档。直接多次调用arrayContains会被Firebase限制，而arrayContainsAny会返回满足任一条件的文档，不符合需求：

被限制的错误代码 #

// 无法执行，Firebase不允许对同一字段多次使用arrayContains
FirebaseFirestore.instance
          .collection('people')
          .where('characteristics', arrayContains: 'brown hair')
          .where('characteristics', arrayContains: 'brown eyes')
          .orderBy('age', descending: true)
          .limit(30)
          .get();

结果不符合预期的代码 #

// 返回包含任一特征的文档，不满足同时匹配的要求
FirebaseFirestore.instance
          .collection('people')
          .where('characteristics', arrayContainsAny: ['brown hair','brown eyes'])
          .orderBy('age', descending: true)
          .limit(30)
          .get();

最佳实践 #

1. 重构数据结构（推荐） #

把characteristics数组改成键值对Map结构，将每个特征作为键，值设为true，示例文档结构：

{
  "characteristics": {
    "brown hair": true,
    "brown eyes": true,
    "blue eyes": false
  },
  "age": 28
}

这种结构下可以通过多个where条件实现逻辑AND查询，Firestore允许对不同的Map键进行条件过滤：

FirebaseFirestore.instance
    .collection('people')
    .where('characteristics.brown hair', isEqualTo: true)
    .where('characteristics.brown eyes', isEqualTo: true)
    .orderBy('age', descending: true)
    .limit(30)
    .get();

该方式查询效率最高，完全在服务端完成过滤，无额外客户端开销。

2. 客户端二次过滤（适合小数据集） #

如果无法修改现有数据结构，可以先查询包含其中一个特征的文档，再在客户端过滤出同时包含另一个特征的结果：

final querySnapshot = await FirebaseFirestore.instance
    .collection('people')
    .where('characteristics', arrayContains: 'brown hair')
    .orderBy('age', descending: true)
    .limit(30)
    .get();

// 客户端过滤同时包含brown eyes的文档
final filteredDocs = querySnapshot.docs.where((doc) {
  final characteristics = doc.data()['characteristics'] as List;
  return characteristics.contains('brown eyes');
}).toList();

注意：该方式会读取所有包含brown hair的文档，若数据集较大，会增加读取成本和客户端处理时间，仅适合数据量较小的场景。

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