Flutter中Firestore多条件复合查询无返回结果问题求助

查询游标传值和orderBy字段顺序不匹配，属于Firestore复合查询的常见规则坑：

• Firestore明确要求startAt/startAfter/endAt/endBefore传入的游标值数组，必须和orderBy声明的字段顺序严格一一对应，不能跳过前置排序字段，直接给后置字段传游标条件。
• 你当前的查询排序顺序是先按price升序、再按name升序，但startAt和endAt只传了name字段的前缀匹配值，传入的字符串会被Firestore默认当成第一个排序字段price的游标值——相当于拿字符串去和数字类型的price做范围匹配，类型不匹配自然查不到任何结果。这类隐式类型不匹配Firestore不会主动抛出错误，只会返回空结果集。
• 这也是单独测价格区间筛选、单独测名称前缀匹配都能正常运行的原因：单一场景下排序字段和游标值是对应匹配的，组合查询时多了前置的price排序字段，游标没有同步调整才触发问题。
• 你贴出的运行日志全是MIUI输入事件、帧率统计相关的系统日志，没有任何Firestore查询相关的报错输出，和本次查询失败没有关联。

给游标补全第一个排序字段price的对应边界值，保证游标数组顺序和orderBy字段顺序完全对齐，修正后的代码如下：

int priceMax, priceMin;
String product;
searchQuery =  FirebaseFirestore.instance.collection("Products")
        .where("price", isLessThanOrEqualTo: priceMax)
        .where("price", isGreaterThanOrEqualTo: priceMin)
        .orderBy("price")
        .orderBy("name")
        // 游标第一个值对应price排序的起始边界，第二个值对应name排序的起始边界
        .startAt([priceMin, product])
        // 游标第一个值对应price排序的结束边界，第二个值对应name排序的结束边界
        .endAt([priceMax, product + '\uf8ff']);

如果你之前创建的复合索引是price 升序, name 升序，上面的修正代码可以直接复用该索引，不需要重新创建。如果索引字段顺序不匹配，运行查询时控制台会直接弹出索引创建指引，按提示操作即可。

如果修正后仍然返回空结果，逐一核对以下项：

• 执行查询前确认priceMin、priceMax、product三个变量不为null，null值参与范围匹配会直接导致结果为空
• 确认Products集合内确实存在同时满足价格区间、名称前缀匹配规则的文档，避免用边界外的测试数据校验
• 不要随意增减where筛选、orderBy排序的字段顺序，所有参与范围筛选、排序的字段都要和复合索引的字段顺序完全对齐

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