Flutter：diceNumberProvider意外重置为-1，排查是否被销毁重建

一、排查触发Provider状态重置的可能逻辑 #

1. 检查Provider的定义与依赖方式 #

如果diceNumberProvider的定义中，将对homeScreenRecipesProvider的依赖写在了Provider的创建回调里，会导致每次homeScreenRecipesProvider更新（比如过滤食谱）时，重新创建diceNumberProvider的Notifier实例，从而重置状态到初始值-1。

错误示例：

final diceNumberProvider = StateNotifierProvider<DiceNotifier, int>((ref) {
  // 每次homeScreenRecipesProvider变化，都会新建DiceNotifier，状态重置
  final recipes = ref.watch(homeScreenRecipesProvider);
  return DiceNotifier(recipes);
});

2. 检查Widget树的生命周期变化 #

home_screen.dart中TextField的onChanged触发过滤后，若某个包含diceNumberProvider消费逻辑的Widget被条件渲染移除（比如用if判断食谱数量为空时隐藏），再重新渲染，会导致Provider的作用域销毁重建，状态重置。

3. 排查过滤逻辑的副作用 #

检查homeScreenState.dart的过滤代码，是否间接修改了控制Widget树结构的状态（比如切换页面路由、修改父Widget的key），导致依赖diceNumberProvider的Widget被卸载后重建。

二、验证Provider是否被销毁重建 #

1. 在Notifier中添加生命周期日志 #

修改shakeState.dart中的Notifier类，在构造函数和dispose方法中添加打印：

class DiceNotifier extends StateNotifier<int> {
  DiceNotifier() : super(-1) {
    print('[DiceNotifier] 实例已创建');
  }

  @override
  void dispose() {
    print('[DiceNotifier] 实例已销毁');
    super.dispose();
  }

  void roll() {
    // 原有逻辑
    final recipes = ref.read(homeScreenRecipesProvider);
    state = recipes.isEmpty ? -2 : /* 其他逻辑 */;
  }
}

触发TextField的onChanged后，查看控制台是否有实例已销毁和实例已创建的连续打印，即可确认是否发生重建。

2. 使用Riverpod的ref.onDispose回调 #

在diceNumberProvider的定义中添加销毁回调：

final diceNumberProvider = StateNotifierProvider<DiceNotifier, int>((ref) {
  final notifier = DiceNotifier();
  ref.onDispose(() {
    print('[diceNumberProvider] 已销毁');
  });
  return notifier;
});

同样通过控制台日志判断Provider的生命周期变化。

三、针对性修复方案 #

1. 正确处理Provider依赖 #

将对homeScreenRecipesProvider的监听移到Notifier内部，避免依赖变化导致Notifier重建：

class DiceNotifier extends StateNotifier<int> {
  DiceNotifier(this.ref) : super(-1) {
    // 监听食谱列表变化，而非在Provider创建时依赖
    _recipeSubscription = ref.listen(homeScreenRecipesProvider, (prev, curr) {
      if (curr.isEmpty) {
        state = -2;
      }
    });
  }

  final Ref ref;
  late final StreamSubscription _recipeSubscription;

  @override
  void dispose() {
    _recipeSubscription.cancel();
    super.dispose();
  }

  void roll() {
    final recipes = ref.read(homeScreenRecipesProvider);
    if (recipes.isEmpty) {
      state = -2;
    } else {
      // 原有掷骰子逻辑
    }
  }
}

// Provider定义改为不直接依赖homeScreenRecipesProvider
final diceNumberProvider = StateNotifierProvider<DiceNotifier, int>((ref) {
  return DiceNotifier(ref);
});

2. 避免不必要的Widget重建 #

给home_screen.dart中依赖diceNumberProvider的父Widget添加固定Key，防止过滤时Widget被意外重建：

// 示例：给包含骰子逻辑的Widget添加固定Key
Consumer(
  key: const Key('dice_consumer'),
  builder: (context, ref, child) {
    // 消费diceNumberProvider的逻辑
  },
)

3. 排查StateProvider的意外赋值 #

如果diceNumberProvider是StateProvider，检查是否有其他逻辑（比如过滤后的回调）间接调用了state = -1，重置了状态。

内容的提问来源于stack exchange，提问作者강수경