Flutter中使用connectivity插件时Stream Subscription抛出异常问题

我之前在用connectivity插件（现在更推荐官方维护的connectivity_plus）时也碰到过一模一样的问题——哪怕已经做了空值检查，偶尔还是会弹出这个异常。其实根源大多是流订阅的生命周期和Widget生命周期的竞态条件，或者重复调用了取消订阅的方法。下面给你几个实用的解决思路：

1. 捕获取消订阅时的异常 #

这个异常本质是插件内部抛出的：当你尝试取消一个已经被关闭/取消过的流订阅时就会触发。既然这个异常不影响功能，只是污染日志，我们可以直接在dispose里用try-catch包裹取消操作：

@override
void dispose() {
  try {
    streamConnectionStatus?.cancel();
  } catch (_) {
    // 忽略这个无影响的异常
  }
  super.dispose();
}

2. 严谨管理订阅的生命周期 #

有时候问题出在重复订阅或者订阅未正确初始化就被取消。可以优化订阅管理逻辑，确保每次初始化前先清理旧订阅，取消后将订阅对象置为null：

StreamSubscription? streamConnectionStatus;

@override
void initState() {
  super.initState();
  _setupConnectionListener();
}

void _setupConnectionListener() {
  // 先清理旧的订阅，避免重复监听
  if (streamConnectionStatus != null) {
    try {
      streamConnectionStatus!.cancel();
    } catch (_) {}
    streamConnectionStatus = null;
  }
  // 新建订阅
  streamConnectionStatus = Connectivity().onConnectivityChanged.listen((status) {
    // 处理你的网络状态逻辑
  });
}

@override
void dispose() {
  try {
    streamConnectionStatus?.cancel();
    streamConnectionStatus = null;
  } catch (_) {}
  super.dispose();
}

3. 升级到官方推荐的connectivity_plus插件 #

旧版的connectivity插件已经被弃用，官方现在维护的connectivity_plus修复了不少旧版的bug，包括这类生命周期相关的异常。你可以在pubspec.yaml里替换依赖：

dependencies:
  connectivity_plus: ^5.0.1 # 替换为当前最新稳定版

4. 避免Widget快速重建时的竞态 #

如果你的Widget经常被快速销毁重建（比如Tab切换、路由快速跳转返回），可以在deactivate和activate方法里处理订阅的暂停/恢复，确保Widget状态变化时订阅能及时跟上：

@override
void deactivate() {
  // 暂时取消订阅，避免Widget在后台时仍监听
  streamConnectionStatus?.pause();
  super.deactivate();
}

@override
void activate() {
  super.activate();
  // 恢复订阅
  streamConnectionStatus?.resume();
}

这样处理之后，那个烦人的异常应该就不会再出现了。

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