Firestore使用文档快照分页搭配where子句触发order by相关报错

• 查询构造顺序不符合Firestore要求：Firestore的查询必须严格按照「where过滤条件 → order_by排序 → start_after等游标条件 → limit限流」的顺序构建。你当前代码将limit放在order_by和start_after之前，导致查询排序逻辑与游标匹配逻辑混乱，触发字段校验错误。
• 加where子句后报错、移除后正常的原因：当存在相等条件的where子句时，Firestore会隐式将相等过滤的字段加入排序规则前缀，此时会严格校验排序、游标、限流的顺序，没有where子句时排序规则只有__name__一项，错误的顺序暂时没有触发校验规则。
• 潜在风险：未处理首次查询无结果的场景，如果第一次查询没有返回任何文档，lastDoc会是None，直接传入start_after会引发额外参数错误。

def getPayments ():
    col = firestoreClient.collection('payments')
    # 调整查询顺序：过滤→排序→限流
    query = col.where('paymentId', '==', None).order_by('__name__').limit(10)

    lastDoc = None
    for doc in query.stream():
        lastDoc = doc
    
    # 先判断上一页是否有文档，再构造下一页查询
    if lastDoc:
        # 调整顺序：过滤→排序→游标→限流
        query = col.where('paymentId', '==', None).order_by('__name__').start_after(lastDoc).limit(10)
        for doc in query.stream():
            lastDoc = doc

修改后即可正常执行分页查询，同时兼容无查询结果的边界场景。

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