Firestore嵌套Map与数组查询返回空结果问题求解

问题根源 #

Firestore的arrayContains查询有严格限制：它要求完全匹配数组中的整个元素。你当前传入的{'title': {'fa': 'عنوان'}}必须和fields数组里的某一个元素完全一致（包括所有键值对，不能多也不能少）才能匹配成功。如果你的fields数组中的Map元素还包含其他字段（比如type之类的额外键），这个查询就会返回空结果。

可行解决方案 #

方案1：重构数据结构（推荐）

新增一个专门用于查询的数组字段，比如field_titles_fa，存储fields数组中所有title.fa的取值。每次更新fields时同步维护这个数组，之后就可以用arrayContainsAny实现多关键词查询：

StreamBuilder<QuerySnapshot<Map<String, dynamic>>>(
  stream: FirebaseFirestore.instance
    .collection('items')
    .where('category',
                isEqualTo: FirebaseFirestore.instance.doc(
                    '/cate/tweYUyMHTdWJWux1xjsh/subCategories/mA4iWPb56UAF8MczQqpb'))
    .where('field_titles_fa', arrayContainsAny: ['عنوان', 'خانه فروشی'])
    .snapshots(),
  builder: (context, snapshot) {
    // ...
  },
),

这种方式既高效又能满足多关键词查询需求，符合Firestore的查询设计逻辑。

方案2：严格匹配完整数组元素

如果你无法修改数据结构，需要先确认fields数组中目标元素的完整结构。比如数组中实际的元素是{'type': 'title', 'title': {'fa': 'عنوان'}}，那么查询时必须传入完全一致的Map：

.where('fields', arrayContains: {'type': 'title', 'title': {'fa': 'عنوان'}})

这种方式仅适用于数组元素结构固定且你能获取完整结构的场景。

注意事项 #

• arrayContainsAny最多支持同时查询10个元素，若关键词超过10个，需要拆分多次查询后合并结果。
• Firestore不支持直接查询数组中嵌套字段的部分匹配，只能通过上述两种方式绕过限制。

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