Riverpod：在dispose方法中设置StateNotifierProvider状态失败

问题原因 #

在dispose方法中调用ref.read(disconnectString.notifier)触发报错，是因为此时Widget已从Widget树中移除（处于deactivated状态），尝试通过ref访问依赖会触发不安全的上下文查找，进而抛出"Looking up a deactivated widget's ancestor is unsafe"错误。

解决方案 #

方案1：提前保存Notifier实例 #

在页面initState阶段提前获取并保存StateNotifier的引用，避免在dispose时再通过ref读取：

class YourPage extends ConsumerStatefulWidget {
  const YourPage({super.key});

  @override
  ConsumerState<YourPage> createState() => _YourPageState();
}

class _YourPageState extends ConsumerState<YourPage> {
  DisconnectString? _disconnectNotifier;

  @override
  void initState() {
    super.initState();
    // 提前获取Notifier实例并保存
    _disconnectNotifier = ref.read(disconnectString.notifier);
    Future.delayed(Duration.zero, () {
      _disconnectNotifier?.change('A new string value');
    });
  }

  @override
  void dispose() {
    // 直接使用保存的实例修改状态
    _disconnectNotifier?.change('default string value');
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    // 页面UI代码
    return Scaffold();
  }
}

方案2：使用ref.listen监听页面生命周期（可选） #

如果需要更灵活的生命周期管理，可通过ref.listenSelf监听页面销毁事件：

@override
void initState() {
  super.initState();
  final notifier = ref.read(disconnectString.notifier);
  Future.delayed(Duration.zero, () {
    notifier.change('A new string value');
  });
  // 监听页面销毁时重置状态
  ref.listenSelf((previous, next) {
    notifier.change('default string value');
  });
}

方案3：调整Provider为AutoDispose（按需选择） #

如果disconnectString Provider不需要在页面销毁后保留状态，可改为AutoDisposeStateNotifierProvider，页面销毁且无其他监听者时，Provider会自动重置为初始状态：

final disconnectString = AutoDisposeStateNotifierProvider<DisconnectString, String>(
    (ref) => DisconnectString());

这种方式无需手动在dispose中重置，状态会随Provider销毁自动回到默认值。

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