使用Flutter Map插件开发应用，添加代码后出现错误求助

问题描述 #

我正在使用Flutter Map插件开发应用，添加以下代码后出现错误：

• 初始化代码：final Completer<Null> _readyCompleter = Completer<Null>();
• 地理位置查询方法：

Stream<List<DocumentSnapshot>> getDataCollectionByLocation({
    required GeoFirePoint center,
    required double radius,
    required String field,
  }) {
    Stream<List<DocumentSnapshot>> stream = _geo
        .collection(collectionRef: ref)
        .within(center: center, radius: radius, field: field);
    return stream;
  }

常见错误原因与解决方案 #

1. 修复过时的Completer泛型类型 #

Dart 2.12+ 中Null作为泛型参数已被弃用，需替换为void：

final Completer<void> _readyCompleter = Completer<void>();

2. 匹配Stream返回类型 #

_geo.collection().within()方法实际返回的可能是Stream<List<DocumentSnapshot<Object?>>>，与你声明的Stream<List<DocumentSnapshot>>存在类型差异，可通过两种方式修复：

• 直接调整方法返回类型：

Stream<List<DocumentSnapshot<Object?>>> getDataCollectionByLocation({
    required GeoFirePoint center,
    required double radius,
    required String field,
  }) {
    return _geo
        .collection(collectionRef: ref)
        .within(center: center, radius: radius, field: field);
  }

• 使用类型转换兼容：

Stream<List<DocumentSnapshot>> getDataCollectionByLocation({
    required GeoFirePoint center,
    required double radius,
    required String field,
  }) {
    return _geo
        .collection(collectionRef: ref)
        .within(center: center, radius: radius, field: field)
        .map((snapshots) => snapshots.cast<DocumentSnapshot>());
  }

3. 校验依赖版本兼容性 #

检查geoflutterfire（或你使用的GeoFire类库）与cloud_firestore、flutter_map的版本是否匹配，版本不兼容常导致API调用异常。建议在pubspec.yaml中更新至最新兼容版本，执行flutter pub get后重新运行项目。

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