Flutter中如何按Firestore文档内指定分类值查询并每次获取10条数据

实现方法 #

Firestore 针对数组类型字段的包含查询，直接使用 array-contains 运算符即可，不需要显式访问数组的下标或元素名称，以下是对应场景的实现方案：

场景1：categories 数组元素为分类名称字符串

如果你的 categories 字段存储的是 ["Mystery", "Suspense", "Romance"] 这类字符串格式的分类名，直接用如下代码查询即可（以 Web 端 SDK 为例）：

import { collection, query, where, limit } from "firebase/firestore";

// 构造查询：查询categories数组包含Mystery的series文档，最多返回10条
const seriesQuery = query(
  collection(db, "series"),
  where("categories", "array-contains", "Mystery"),
  limit(10)
);

场景2：categories 数组元素为对象

如果 categories 数组存储的是对象类型的分类数据，那么 array-contains 需要完全匹配整个对象结构才能命中。如果需要按对象内的某个属性（比如分类名）查询，建议提前做字段冗余：新增一个 categoryNames 数组字段，专门存储所有分类的名称字符串，再按上述场景1的方案查询 categoryNames 字段即可。

补充说明 #

• 如需一次查询匹配多个分类，可以将运算符替换为 array-contains-any，最多支持传入10个匹配值
• 如果分类和流派是两个独立的数组字段，要实现「匹配指定分类 或 匹配指定流派」的逻辑，可以配合 or 运算符实现：

import { collection, query, where, limit, or } from "firebase/firestore";

const seriesQuery = query(
  collection(db, "series"),
  or(
    where("categories", "array-contains", "Mystery"),
    where("genres", "array-contains", "Detective")
  ),
  limit(10)
);

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