Flutter中Riverpod Notifier调用build时状态重置的修复方案

常见原因及对应修复方案 #

1. 错误在build()方法内初始化固定状态 #

Riverpod的Notifier的build()会在Notifier因依赖变化重建时重复执行，若你在这里直接返回固定初始状态，每次重建都会重置状态。正确的初始化方式是在构造函数或initialState getter中设置初始值。

错误示例：

class GeneratorsNotifier extends Notifier<GeneratorsState> {
  @override
  GeneratorsState build() {
    // 每次build都会触发状态重置
    return GeneratorsState.initial();
  }
}

修复后：

class GeneratorsNotifier extends Notifier<GeneratorsState> {
  @override
  GeneratorsState build() {
    // 仅在这里处理依赖其他Provider的动态初始值，比如：
    // final gameStatus = ref.watch(gameStatusProvider);
    // return GeneratorsState.fromGameStatus(gameStatus);
    return state;
  }

  // 通过构造函数初始化
  GeneratorsNotifier() {
    state = GeneratorsState.initial();
  }

  // 或者用initialState getter（更符合Riverpod规范）
  // @override
  // GeneratorsState get initialState => GeneratorsState.initial();
}

2. Provider注解或类型定义错误 #

确保@riverpod注解生成的Provider类型正确，避免因类型不匹配导致Notifier重复实例化。

错误示例：

@riverpod
GeneratorsNotifier generators(GeneratorsRef ref) {
  return GeneratorsNotifier();
}

正确示例（Riverpod 2.x+）：

@riverpod
class Generators extends _$Generators {
  @override
  GeneratorsState build() {
    // 仅处理依赖动态值，不要返回固定初始状态
    return initialState;
  }

  @override
  GeneratorsState get initialState => GeneratorsState.initial();
}

3. 状态更新方式错误 #

确保所有状态更新都通过修改state属性实现，不要重新创建Notifier实例：

正确的更新逻辑：

void addGenerator(Generator newGenerator) {
  state = state.copyWith(
    generators: [...state.generators, newGenerator]
  );
}

4. 检查Provider作用域 #

如果GeneratorsNotifier被放在临时ProviderScope（比如页面级的ProviderScope）中，页面销毁重建时Notifier会被重新创建，状态随之重置。将其移至全局或持久化的ProviderScope中即可解决。

额外排查建议 #

• 对比GameStatusNotifier的实现，复制它的状态初始化和Provider定义模式到GeneratorsNotifier
• 检查代码中是否存在ref.invalidate(generatorsProvider)调用，该方法会强制重置Notifier状态

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