Flutter中PositionStream无法更新地图定位的问题咨询

我开发了一款带地图的Flutter应用，用来展示用户位置。模拟器修改坐标时标记能正常移动，但物理设备上标记完全不动。使用Geolocator的Stream来更新位置，代码如下：

Position? currentPosition;
StreamSubscription<Position>? positionStream;

void listenToLocationChanges() {

  LocationIndicator locationIndicator = LocationIndicator();
  locationIndicator.locationIndicatorStyle = LocationIndicatorIndicatorStyle.pedestrian;

  final LocationSettings locationSettings = LocationSettings(
    accuracy: LocationAccuracy.high,
    distanceFilter: 100,
  );

  positionStream = Geolocator.getPositionStream(locationSettings: locationSettings).listen(
    (Position? position) {
      print(position==null? 'Unknown' : '$position'); 
      

  currentPosition = position;

  GeoCoordinates geoCoordinates = GeoCoordinates (position!.latitude, position.longitude);
  bearing = position.heading;
  currentlat = position.latitude;
  currentlong = position.longitude;

  Location location = Location.withCoordinates(geoCoordinates);
  location.time = DateTime.now();
  location.bearingInDegrees = bearing;
 
  locationIndicator.updateLocation(location);

  _hereMapController.addLifecycleListener(locationIndicator);
  _locationIndicatorList.add(locationIndicator);

    },
  );
}

以下是可能的原因和对应的解决方法：

1. 重复创建并添加LocationIndicator导致冲突 #

每次位置回调都会新建LocationIndicator，还重复调用addLifecycleListener并加入列表，这会导致旧的指示器未被清理，新的指示器无法正常接管显示，物理设备的资源限制会放大这个问题。

解决方法：
把LocationIndicator的初始化和生命周期监听移到Stream外部，只在初始化时执行一次，回调里仅更新位置：

Position? currentPosition;
StreamSubscription<Position>? positionStream;
LocationIndicator? locationIndicator; // 声明为成员变量

void listenToLocationChanges() {
  // 初始化LocationIndicator仅一次
  locationIndicator = LocationIndicator();
  locationIndicator!.locationIndicatorStyle = LocationIndicatorIndicatorStyle.pedestrian;
  _hereMapController.addLifecycleListener(locationIndicator!);
  _locationIndicatorList.add(locationIndicator!);

  final LocationSettings locationSettings = LocationSettings(
    accuracy: LocationAccuracy.high,
    distanceFilter: 100,
  );

  positionStream = Geolocator.getPositionStream(locationSettings: locationSettings).listen(
    (Position? position) {
      print(position == null ? 'Unknown' : '$position'); 
      if (position == null) return;

      currentPosition = position;
      bearing = position.heading;
      currentlat = position.latitude;
      currentlong = position.longitude;

      final GeoCoordinates geoCoordinates = GeoCoordinates(position.latitude, position.longitude);
      final Location location = Location.withCoordinates(geoCoordinates);
      location.time = DateTime.now();
      location.bearingInDegrees = bearing;
     
      // 仅更新已有指示器的位置
      locationIndicator?.updateLocation(location);
    },
  );
}

2. 物理设备定位权限未正确配置或授予 #

模拟器通常默认授予定位权限，而物理设备需要明确申请权限，若缺少精确定位或后台定位权限，Geolocator无法获取位置更新。

解决方法：

• Android：在android/app/src/main/AndroidManifest.xml中添加权限声明：

  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
  <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
  <!-- 若需要后台更新位置 -->
  <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
  

• iOS：在ios/Runner/Info.plist中添加权限描述：

  <key>NSLocationWhenInUseUsageDescription</key>
  <string>需要获取您的位置以展示地图标记</string>
  <key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
  <string>后台需要获取您的位置以更新标记</string>
  

• 代码中主动请求权限：

  Future<void> requestLocationPermission() async {
    bool serviceEnabled;
    LocationPermission permission;
  
    serviceEnabled = await Geolocator.isLocationServiceEnabled();
    if (!serviceEnabled) {
      // 提示用户开启定位服务
      return;
    }
  
    permission = await Geolocator.checkPermission();
    if (permission == LocationPermission.denied) {
      permission = await Geolocator.requestPermission();
      if (permission == LocationPermission.denied) {
        // 权限被拒绝，提示用户
        return;
      }
    }
  
    if (permission == LocationPermission.deniedForever) {
      // 权限永久拒绝，引导用户到设置页开启
      return;
    }
  }
  

  在启动定位前先调用requestLocationPermission确保权限已授予。

3. LocationSettings的distanceFilter设置过大 #

代码中设置了distanceFilter: 100，意味着只有当位置变化超过100米时才会触发Stream回调。物理设备上如果用户没有移动足够距离，就不会收到更新；而模拟器可以直接修改坐标，不受距离限制。

解决方法：
根据需求调整distanceFilter，如果需要实时更新位置，可将其设为0：

final LocationSettings locationSettings = LocationSettings(
  accuracy: LocationAccuracy.high,
  distanceFilter: 0, // 修改为0或更小的阈值
);

4. 未处理position为null的情况 #

代码中使用position!强制解包，若物理设备上定位失败导致position为null，会抛出异常中断后续更新逻辑，而模拟器中position不会为null，因此问题未暴露。

解决方法：
添加空判断，避免强制解包：

if (position == null) {
  print('位置获取失败');
  return;
}
// 后续使用position时无需强制解包
final GeoCoordinates geoCoordinates = GeoCoordinates(position.latitude, position.longitude);

5. 未正确管理Stream订阅与地图控制器生命周期 #

若页面销毁时未取消positionStream的订阅，或未清理LocationIndicator，会导致内存泄漏，物理设备上可能出现更新失效的情况。

解决方法：
在页面的dispose方法中清理资源：

@override
void dispose() {
  // 取消位置流订阅
  positionStream?.cancel();
  // 移除地图生命周期监听并清理指示器列表
  if (locationIndicator != null) {
    _hereMapController.removeLifecycleListener(locationIndicator!);
    _locationIndicatorList.remove(locationIndicator);
  }
  super.dispose();
}

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