使用Geoflutterfire的within查询为何出现重复结果？

以下是导致查询结果重复的常见原因和对应解决办法：

1. Geoflutterfire 地理哈希查询的特性 #

当启用strictMode: true时，within方法会先通过地理哈希范围筛选出候选文档，再对这些文档进行精确距离校验。如果某个文档恰好处于两个相邻哈希单元格的边界，就会被两次纳入候选集，最终出现在结果列表中。

解决办法：
在接收Stream数据后，利用文档ID的唯一性进行去重处理：

// 处理Stream时执行去重
getNearbyStream(center: myPosition, radius: 10)
  .map((docs) {
    final uniqueDocsMap = <String, DocumentSnapshot<Map<String, dynamic>>>{};
    for (final doc in docs) {
      uniqueDocsMap[doc.id] = doc;
    }
    return uniqueDocsMap.values.toList();
  })
  .listen((uniqueResult) {
    // 使用去重后的结果列表
  });

2. 重复订阅Stream #

如果代码中多次订阅了同一个getNearbyStream返回的Stream，或是在Widget的build方法中未正确管理订阅（比如直接调用而未用StreamBuilder），可能会导致多次接收相同数据。

解决办法：

• 使用StreamBuilder统一管理订阅，确保仅订阅一次；
• 手动管理订阅时，在组件销毁时调用cancel()方法取消订阅，避免重复监听。

3. Geoflutterfire 版本bug #

部分旧版本的Geoflutterfire存在查询结果重复的已知问题，建议升级到最新稳定版本。

解决办法：
在pubspec.yaml中更新依赖版本：

dependencies:
  geoflutterfire: ^4.0.0 # 替换为当前最新稳定版本

内容的提问来源于stack exchange，提问作者Stéphane de Luca