Flutter Riverpod报错：Widget销毁后无法使用ref的问题求助

错误原因 #

这个StateError的核心是：当前Widget已经被销毁（disposed），但代码仍在尝试使用ref访问Riverpod Provider。VSCode开启全异常检测时会捕获这类潜在风险，虽然项目运行时未崩溃，但这是不符合Widget生命周期规范的操作，可能引发内存泄漏或后续不可预期的错误。

常见触发场景：

• 页面初始化的异步任务（比如loadData里的多个Provider异步方法）还未完成，用户就退出了当前页面，Widget被销毁，但异步任务结束后依然执行了ref.read操作。
• 点击搜索按钮时，Widget已经处于销毁状态（比如快速切换页面后点击），loadEksperList里的ref.read依然被调用。

解决方法 #

1. 每次使用ref前检查Widget是否已挂载 #

在State类中，mounted属性会在Widget被销毁后变为false，所有涉及ref的操作前都先判断这个属性：

修改loadData方法：

Future<void> loadData() async {
  if (!mounted) return;
  await ref.read(userProvider.notifier).loadUser();
  
  if (!mounted) return;
  await ref.read(memberShipProvider.notifier).getMembershipInfo();
  
  if (!mounted) return;
  await ref.read(cityProvider.notifier).getCityList();
  
  if (!mounted) return;
  await ref.read(merkezEkspertizProvider.notifier).getMerkezEkspertizList();
  
  if (!mounted) return;
  _eksperOzetListFuture = ref.read(mainEkspertizOzetProvider.notifier).getMainEkspertizOzetList("");
}

修改搜索按钮对应的loadEksperList方法：

void loadEksperList(String merkez) async {
  if (!mounted) return;
  _eksperOzetListFuture = ref.read(mainEkspertizOzetProvider.notifier).getMainEkspertizOzetList(merkez);
}

2. 取消未完成的异步任务（可选，更严谨） #

如果异步任务（比如网络请求、数据库查询）耗时较长，建议在Widget销毁时取消这些任务，避免不必要的后续执行：

• 若使用Dio发起网络请求，可以给请求添加CancelToken，在dispose方法中调用cancel()。
• 对自定义异步任务，可以使用Completer或Future的取消机制，在dispose中终止任务。

示例（假设用Dio的CancelToken）：

CancelToken? _cityListCancelToken;

@override
void initState() {
  _cityListCancelToken = CancelToken();
  super.initState();
}

// 修改getCityList方法，传入CancelToken
Future<void> getCityList(CancelToken cancelToken) async {
  // ... 原有代码
  var response = await Api().getFromApiWithoutResult(
    'Liste/IlGetir',
    userData['mobileId'] as String,
    null,
    userData['token'] as String,
    cancelToken: cancelToken, // 传入取消令牌
  );
  // ... 原有代码
}

@override
void dispose() {
  _cityListCancelToken?.cancel("Widget已销毁，取消请求");
  super.dispose();
}

3. 优化Riverpod Provider的使用逻辑 #

确保Provider的作用域与Widget生命周期匹配：

• 如果是页面级的Provider，使用StateProvider或NotifierProvider时，通过ref.watch自动监听生命周期，避免手动调用ref.read时遗漏状态检查。
• 全局Provider的操作无需担心Widget销毁，但页面内的状态更新仍需遵循Widget生命周期规则。

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