firestore 查询结果少于实际文档数，通常是因为缺少复合索引；即使执行无条件查询也偶现此问题，根本原因多为未按规则创建必要索引，导致查询被静默截断或失败。
firestore 查询结果少于实际文档数，通常是因为缺少复合索引；即使执行无条件查询也偶现此问题，根本原因多为未按规则创建必要索引，导致查询被静默截断或失败。
在 Firestore 中，当你对集合执行带排序（orderBy）和范围过滤（如 whereGreaterThanOrEqualTo + whereLessThanOrEqualTo）的复合查询时，必须手动创建对应的复合索引，否则查询将无法正确执行——但 Firebase SDK 不会抛出明确错误，而是可能返回空结果、部分结果（如仅 8/20 条），甚至在某些情况下静默失败。这正是你遇到的核心问题。
你最初的查询：
mFStore.collection("In")
.orderBy("Time of submit", Query.Direction.ASCENDING)
.whereGreaterThanOrEqualTo("Time of submit", startDateTimeStamp)
.whereLessThanOrEqualTo("Time of submit", endDateTimeStamp)
.get()属于典型的「排序 + 双边界范围查询」，它要求 Firestore 同时按 "Time of submit" 字段排序并高效筛选区间。而 Firestore 默认仅对单字段查询自动建立索引，复合查询必须显式配置索引。
✅ 正确解决方案：创建复合索引
-
触发索引创建提示：首次运行该查询时，若索引缺失，Firebase 控制台日志（Logcat）中会出现类似如下警告（注意查看 W/Firestore 或 E/Firestore 级别日志）：
FAILED_PRECONDITION: The query requires an index. ...
一键跳转创建（推荐）：
在 Android Studio 的 Logcat 中点击该警告日志，会自动生成带参数的索引创建链接，点击即可跳转至 Firebase 控制台的索引配置页，预填好字段与方向。-
手动创建步骤（备用）：
- 进入 Firebase Console → Firestore → 索引
- 点击「+ 添加索引」→ 选择集合 In
- 添加字段：
- Time of submit → Asc（与 orderBy 方向一致）
- Time of submit → Range（用于 >= 和
- 保存后，索引状态变为 Building，通常需数秒至数分钟生效。
⚠️ 注意：字段名必须完全匹配（包括空格和大小写），例如 "Time of submit" 不可写作 "timeOfSubmit" 或 "time_of_submit"。
? 验证是否真正获取全部文档
即使索引已就绪，也建议添加基础校验逻辑，避免因数据为空或类型异常导致日志遗漏：
@Override
public void onSuccess(QuerySnapshot queryDocumentSnapshots) {
Log.d(TAG, "Query returned " + queryDocumentSnapshots.size() + " documents");
List<DocumentSnapshot> snapshots = queryDocumentSnapshots.getDocuments();
if (snapshots.isEmpty()) {
Log.w(TAG, "No documents matched the query.");
return;
}
SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd", Locale.getDefault());
for (DocumentSnapshot snapshot : snapshots) {
try {
Object timeObj = snapshot.getData().get("Time of submit");
if (timeObj instanceof Timestamp) {
Date date = ((Timestamp) timeObj).toDate();
String day = format.format(date);
String strQty = String.valueOf(snapshot.get("Quantity")); // 安全转换
Log.d(TAG, day + ", " + strQty);
} else {
Log.w(TAG, "Invalid 'Time of submit' type in doc: " + snapshot.getId());
}
} catch (Exception e) {
Log.e(TAG, "Error processing document " + snapshot.getId(), e);
}
}
}? 补充说明：为何无条件 .get() 也只返回 15 条？
虽然 .collection("In").get() 不需要索引，但若集合中存在权限规则限制（Security Rules）、客户端离线缓存不完整，或文档包含无法反序列化的字段类型（如未处理的 null 或嵌套对象），也可能导致 QuerySnapshot 实际包含的 DocumentSnapshot 少于预期。不过根据你的描述和典型场景，索引缺失仍是首要排查项——尤其当添加索引后问题立即解决，即可确认根因。
✅ 总结
- Firestore 复合查询（排序 + 范围条件）强制依赖手动创建的复合索引；
- 缺失索引不会崩溃应用，但会导致查询结果不完整且无明确报错；
- 始终检查 Logcat 中的索引缺失警告，并通过 Firebase 控制台快速创建；
- 在业务代码中加入 queryDocumentSnapshots.size() 日志与空值/类型防护，提升调试效率。
索引是 Firestore 高性能查询的基石，而非可选项——养成“写查询前先查索引”习惯，可避免 90% 的“数据丢失”类疑难问题。
