Flutter中StreamSubscription二次调用失效问题求助

核心问题分析 #

你遇到的问题根源在于：

1. 位置流的订阅对象是局部变量，离开页面后无法取消订阅，导致资源占用，再次进入时无法正常创建新订阅
2. 每次调用方法都重复创建LocationIndicator并添加生命周期监听，造成冗余和潜在异常
3. 未在页面生命周期变化时管理订阅的启停

具体解决步骤 #

1. 提升订阅与指示器为类成员变量

将StreamSubscription和LocationIndicator声明为State类的成员，而非方法内的局部变量，方便跨方法管理生命周期：

StreamSubscription<Position>? _positionStream;
LocationIndicator? _locationIndicator;

2. 重构位置跟踪初始化逻辑

修改初始化方法，避免重复创建指示器，同时每次订阅前先取消旧订阅：

void _initLocationTracking(LocationIndicatorIndicatorStyle indicatorStyle) {
  // 仅初始化一次位置指示器，避免重复添加监听
  if (_locationIndicator == null) {
    _locationIndicator = LocationIndicator()
      ..locationIndicatorStyle = indicatorStyle;
    _hereMapController.addLifecycleListener(_locationIndicator!);
    _locationIndicatorList.add(_locationIndicator!);
  }

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

  // 先取消旧订阅，防止多订阅冲突
  _positionStream?.cancel();

  // 重新订阅位置流
  _positionStream = Geolocator.getPositionStream(locationSettings: locationSettings).listen((Position position) {
    final GeoCoordinates geoCoordinates = GeoCoordinates(position.latitude, position.longitude);
    bearing = position.heading;

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

    _locationIndicator?.updateLocation(location);
  });
}

3. 在页面生命周期中管理订阅

在页面销毁时取消订阅、清理指示器；在页面恢复可见时重新启动跟踪：

@override
void dispose() {
  // 销毁页面时彻底清理资源
  _positionStream?.cancel();
  if (_locationIndicator != null) {
    _hereMapController.removeLifecycleListener(_locationIndicator!);
    _locationIndicatorList.remove(_locationIndicator!);
  }
  super.dispose();
}

@override
void didChangeAppLifecycleState(AppLifecycleState state) {
  super.didChangeAppLifecycleState(state);
  if (state == AppLifecycleState.resumed) {
    // 页面回到前台时重新启动位置跟踪
    _initLocationTracking(yourIndicatorStyle); // 替换为你的指示器样式
  } else if (state == AppLifecycleState.paused) {
    // 页面退到后台时暂停订阅，节省资源
    _positionStream?.cancel();
    _positionStream = null;
  }
}

4. 确保页面返回时触发初始化

如果你的页面是通过Navigator.push跳转后返回，可在initState中首次初始化，并在页面可见时检查并重启：

@override
void initState() {
  super.initState();
  _initLocationTracking(yourIndicatorStyle);
}

@override
void didChangeDependencies() {
  super.didChangeDependencies();
  // 页面依赖变化时（如返回后）重启跟踪
  if (_positionStream == null) {
    _initLocationTracking(yourIndicatorStyle);
  }
}

关于广播流的说明 #

不需要将流转为广播流：Geolocator的getPositionStream每次调用都会返回一个全新的单订阅流，只要做好订阅的启停管理，完全可以满足需求。使用广播流反而可能导致多订阅同时存在，浪费设备资源。

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