firestore 查询未返回全部文档，通常是因为缺少复合索引——尤其在使用 orderby 配合 where 条件（如 wheregreaterthanorequalto + wherelessthanorequalto）时，firebase 会静默限制结果或直接报错（部分 sdk 版本可能仅返回部分数据而不抛异常），必须手动在 firebase 控制台创建对应索引。
firestore 查询未返回全部文档，通常是因为缺少复合索引——尤其在使用 orderby 配合 where 条件（如 wheregreaterthanorequalto + wherelessthanorequalto）时，firebase 会静默限制结果或直接报错（部分 sdk 版本可能仅返回部分数据而不抛异常），必须手动在 firebase 控制台创建对应索引。
在 Firestore 中，并非所有查询都能“开箱即用”。你遇到的现象——集合明明有 20 条文档，但带排序和范围过滤的查询只返回 8 条；甚至去掉所有条件后仍只返回 15 条——这极大概率不是代码逻辑错误，而是 Firestore 的索引机制在起作用。
? 根本原因：复合索引缺失
Firestore 对以下两类查询强制要求复合索引：
- orderBy() + 至少一个 where()（如 >= /
- 多字段 where() 组合（如 where("a", ">=", 1).where("b", "
你的查询：
mFStore.collection("In")
.orderBy("Time of submit", Query.Direction.ASCENDING)
.whereGreaterThanOrEqualTo("Time of submit", startDateTimeStamp)
.whereLessThanOrEqualTo("Time of submit", endDateTimeStamp)属于典型的「排序 + 双边界范围查询」，必须依赖复合索引。若未配置，Android SDK（尤其是较新版本）不会抛出明确异常，而是：
- 返回部分匹配结果（如仅前 8 条）；
- 或在日志中输出警告（如 WARN: A full collection scan was performed...）；
- 极少数情况下静默失败——这正是你观察到“数量对不上”的核心原因。
✅ 注意：单字段 .get() 全量读取（无 where/orderBy）无需索引，但若仍只返回 15 条，需排查是否存在其他隐式过滤（如安全规则限制、客户端网络中断、或文档实际被软删除）——但优先验证索引问题。
✅ 正确解决方案：创建复合索引
-
触发索引创建提示（推荐）：
首次运行该查询时，在 Logcat 中搜索 Failed to query 或 index 关键字，Firebase 通常会输出类似提示：FAILED_PRECONDITION: The query requires an index. You can create it here: https://www.php.cn/link/22c9c13f11355d93ee0cc26ce01585c9v1/r/project/...
点击链接，Firebase 控制台将自动预填索引字段，点击 Create Index 即可。
-
手动创建（备用）：
- 进入 Firebase Console → 你的项目 → Firestore Database → Indexes 标签页；
- 点击 Add Index；
- Collection ID: In；
- Fields:
- Time of submit → Ascending（与 orderBy 顺序一致）；
- Time of submit → Ascending（再次添加，用于支持范围查询）；
- 索引类型选择 Composite；
- 保存并等待（通常 1–2 分钟生效）。
⚠️ 重要：索引字段顺序必须严格匹配查询顺序！orderBy 字段必须放在 where 字段之前。此处因 orderBy 和 where 同为 Time of submit，需在索引中将其设为首个升序字段（系统会自动处理同字段多条件）。
? 验证与最佳实践
- 测试索引是否生效：部署索引后，重新运行查询，检查 Logcat 是否仍有索引警告；同时确认 snapshotList.size() 返回预期数量（如 20）。
- 避免全量扫描陷阱：永远不要依赖 .get() 代替带条件的查询来“绕过索引”。随着数据增长，全量读取将导致性能骤降与费用飙升。
- 命名规范建议：将字段名 Time of submit 改为 time_of_submit（下划线分隔、小写）。空格和大小写混合易引发拼写错误，且不符合 Firestore 最佳实践。
? 总结
Firestore 的索引机制是其高性能查询的基石，但也是一道常被忽视的“隐形门槛”。当你发现查询结果数量异常时，请按此顺序排查：
- 检查 Logcat 是否有索引缺失警告（最直接线索）；
- 确认查询是否含 orderBy + where 组合 → 必须配复合索引；
- 登录 Firebase 控制台创建对应索引；
- 等待索引激活后重试。
完成索引配置后，你的查询将稳定返回全部匹配文档——不再丢失，也不再静默截断。
