Firestore查询问题：如何筛选附近文档并按时间戳排序？

你的问题核心在于Firestore的排序规则：查询的排序优先级由orderBy的调用顺序决定——你当前先按geohash排序，再按timestamp降序，导致结果先按地理位置分组，仅在同一地理范围内才按时间倒序，而非全局按时间排序。

方案1：客户端排序（快速落地） #

先获取符合地理范围的文档，再在客户端对结果按timestamp全局降序排序。适合数据量不大、对分页精度要求不高的场景：

DocumentSnapshot<Object?>? lastFetchedDoc;  // 用于分页

Future<void> getReviews() async {
  Query<Map<String, dynamic>> query = firestore
        .collectionGroup("reviews")
        .where("city", whereIn: ['New York', 'Philadelphia', 'Washington'])
        .where('geohash', isGreaterThanOrEqualTo: "dph")
        .where('geohash', isLessThanOrEqualTo: "dp~")
        .orderBy('timestamp', descending: true) // 服务端先按时间降序取数，确保拿到最新批次
        .limit(20); // 适当调大limit，避免客户端排序后有效数据不足

  if (lastFetchedDoc != null) {
      query = query.startAfterDocument(lastFetchedDoc!);
  }

  QuerySnapshot snapshot = await query.get();
  
  // 客户端全局按timestamp降序重新排序
  List<QueryDocumentSnapshot> sortedDocs = snapshot.docs
      ..sort((a, b) => (b['timestamp'] as Timestamp).compareTo(a['timestamp'] as Timestamp));
  
  // 更新分页标记为排序后的最后一条文档
  if (sortedDocs.isNotEmpty) {
    lastFetchedDoc = sortedDocs.last;
  }
  
  // 后续业务逻辑使用sortedDocs即可
}

方案2：服务端精准排序（支持分页） #

如果需要严格精准的分页，必须调整索引策略。Firestore复合索引要求排序字段需在过滤字段之后，因此可以新增一个复合字段，将时间分片（如按小时/天）与geohash拼接，实现先按时间分片倒序、再按地理范围排序的效果。

步骤：

1. 写入文档时，新增time_slice_geohash字段，格式为[时间分片字符串]-[geohash]（例：2024052012-dphxxxx）。
2. 在Firestore控制台创建复合索引：针对reviews集合组，包含city、time_slice_geohash（降序）、timestamp（降序）、geohash字段。
3. 查询时按复合字段+时间戳排序：

DocumentSnapshot<Object?>? lastFetchedDoc;  // 用于分页

// 自定义函数：生成最近N个小时的时间分片字符串
List<String> getRecentTimeSlices(int hours) {
  List<String> slices = [];
  DateTime now = DateTime.now();
  for (int i = 0; i < hours; i++) {
    DateTime sliceTime = now.subtract(Duration(hours: i));
    slices.add("${sliceTime.year}${sliceTime.month.toString().padLeft(2, '0')}${sliceTime.day.toString().padLeft(2, '0')}${sliceTime.hour.toString().padLeft(2, '0')}");
  }
  return slices;
}

Future<void> getReviews() async {
  List<String> recentTimeSlices = getRecentTimeSlices(6); // 取最近6小时的分片

  Query<Map<String, dynamic>> query = firestore
        .collectionGroup("reviews")
        .where("city", whereIn: ['New York', 'Philadelphia', 'Washington'])
        .where('time_slice_geohash', whereIn: recentTimeSlices)
        .where('geohash', isGreaterThanOrEqualTo: "dph")
        .where('geohash', isLessThanOrEqualTo: "dp~")
        .orderBy('time_slice_geohash', descending: true)
        .orderBy('timestamp', descending: true)
        .limit(10);

  if (lastFetchedDoc != null) {
      query = query.startAfterDocument(lastFetchedDoc!);
  }

  QuerySnapshot snapshot = await query.get();
  lastFetchedDoc = snapshot.docs.last;
  
  // 此时返回的结果已按时间分片+时间戳降序，符合全局最新要求
}

关键说明 #

• Firestore不支持「先过滤非排序字段，再按完全无关字段全局排序」的查询，因为索引遵循前缀匹配规则，必须满足「过滤字段在前，排序字段在后」的顺序。
• 客户端排序的缺点是：若服务端返回的批次数据全为旧文档，客户端排序后仍无法获取最新内容，因此需适当调大limit。
• 时间分片的粒度需根据业务调整：粒度越细，查询精度越高，但需要维护的分片值越多。

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