firestore 文档本身不支持对单个文档内的数组字段进行服务端分页，因为读取文档时会加载全部内容；正确做法是重构数据模型，将数组元素拆分为独立文档，再通过集合查询实现真正的分页。
在 Firestore 中，无法对单个文档内的数组字段（如 posts: [post1, post2, ...]）进行服务端分页。原因在于：当你调用 .get() 获取一个文档时，SDK 必须完整下载该文档的全部字段——无论数组有多大，整个文档都会被加载到内存中。即使你只想要其中前 10 项，也无法跳过其余部分。
更重要的是，Firestore 对单文档大小有严格限制：最大 1 MiB。这意味着你根本无法在单个文档中存储“数千甚至百万级”数据。一旦数组增长到一定程度，写入就会失败，并抛出 FAILED_PRECONDITION 错误。因此，“文档内数组分页”不仅技术上不可行，更违背了 Firestore 的设计约束。
✅ 正确解决方案：将嵌套数组转为子集合（subcollection）
例如，将原结构：
# users/{uid} → { name: "Alice", posts: [ {...}, {...}, ... ] }重构为：
# users/{uid}/user_posts/{post_id} → { content: "...", timestamp: ..., ... }这样即可利用 Firestore 原生的分页能力：
from google.cloud import firestore
db = firestore.Client()
user_id = "alice123"
# 查询前 10 篇最新动态（按时间倒序）
query = (
db.collection("users")
.document(user_id)
.collection("user_posts")
.order_by("timestamp", direction=firestore.Query.DESCENDING)
.limit(10)
)
docs = query.stream()
# 获取最后一条用于下一页（cursor-based pagination）
last_doc = list(docs)[-1] if docs else None
if last_doc:
next_query = (
db.collection("users")
.document(user_id)
.collection("user_posts")
.order_by("timestamp", direction=firestore.Query.DESCENDING)
.start_after(last_doc)
.limit(10)
)⚠️ 注意事项：
- 避免使用 .offset() 进行跳页（如 offset(100)），它会读取并丢弃前 N 条，造成性能与费用浪费；
- 始终配合 order_by() 使用 start_after() 或 start_at() 实现游标分页；
- 若需全局排序（如按热度+时间混合），可预计算排序权重字段（如 sort_score）并索引；
- 子集合路径无深度限制，但建议保持语义清晰（如 users/{uid}/posts 而非 users/{uid}/data/posts）。
总结：Firestore 的分页能力面向集合查询，而非文档内部结构。面对大规模用户内容，拥抱“以文档为中心”的范式——每个帖子作为独立文档，既符合限额约束，又释放查询、分页、监听与安全规则的全部能力。
