Python中对Firestore查询结果进行分页的代码实现求助

你当前使用的是 Firebase Firestore 数据库，分页可以通过游标机制实现，核心逻辑是记录上一页最后一条文档的快照，作为下一页查询的偏移标记，避免全量扫描数据，性能更稳定。

可直接复用的实现代码 #

你可以把分页逻辑封装为通用方法，适配接口分页或者本地批量遍历场景：

def get_paginated_cases(last_doc_id=None):
    cases_data = {}
    # 基础查询条件和你原逻辑完全一致
    query = db.collection(u'hospitals').document(request.session['hospital_email']).collection('cases')\
        .where(u'status', u'==', "done")\
        .where("formstatus", "==", "draft")\
        .order_by(u'date')\
        .limit(3)
    
    # 非首页查询：传入上一页最后一条文档的ID作为游标
    if last_doc_id is not None:
        last_doc_ref = db.collection(u'hospitals').document(request.session['hospital_email']).collection('cases').document(last_doc_id)
        last_doc = last_doc_ref.get()
        if last_doc.exists:
            query = query.start_after(last_doc)
    
    # 执行查询
    case_docs = query.get()
    current_page_last_id = None
    for doc in case_docs:
        cases_data[doc.id] = doc.to_dict()
        current_page_last_id = doc.id
    
    # 返回当前页数据 + 下一页需要的游标ID，游标为None代表已经到最后一页
    return cases_data, current_page_last_id

使用说明 #

• 拉取第一页数据时，不需要传入last_doc_id，调用get_paginated_cases()即可，拿到当前页3条数据的同时，会返回当前页最后一条文档的ID
• 拉取后续页面时，把上一次返回的current_page_last_id传入方法，就能拿到下一页的3条数据
• 当返回的current_page_last_id为None时，说明已经没有更多数据，无需继续拉取

注意事项 #

• 因为你使用了where加order_by的组合查询，需要先创建对应索引，查询报错时Firestore控制台会直接给出一键创建索引的入口，等待创建完成即可正常使用
• Firestore本身不支持直接跳转到指定页码（比如直接跳第5页），仅支持顺序翻页，如果需要跳页功能需要自行缓存中间页的游标标记

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