Flutter Riverpod：如何仅读取一次Provider中的值

针对你的需求，这里提供几个可行的方案，既能避免在build中使用ref.watch导致重复加载话题，又能安全读取一次用户初始收藏ID：

方案一：直接使用ref.read（明确不监听后续变化） #

虽然文档指出build中使用ref.read是不良实践，但如果明确不需要监听用户收藏列表的后续变化，且仅在初始化时读取一次值，可以这么做。需要注意处理用户状态未初始化的边界情况：

class FollowedTopicsNotifier extends AsyncNotifier<List<FollowableTopic>> {
  @override
  FutureOr<List<FollowableTopic>> build() async {
    final topics = await ref.watch(topicsRepository).fetchTopics();
    // 仅读取一次用户状态，不监听后续更新
    final user = ref.read(userNotifier);
    
    // 处理用户未初始化的情况
    if (user == null) return [];

    final followedTopics = topics.map(
      (topic) => FollowableTopic(
        topic: topic,
        isFollowed: user.followedTopics.contains(topic.id)
      )
    ).toList();

    return followedTopics;
  }

  void updateTopics(String topicId, bool isSelected) {
    // 直接修改本地状态，同时同步更新UserNotifier
    state = AsyncData(state.value!.map((ft) {
      return ft.topic.id == topicId 
          ? ft.copyWith(isFollowed: isSelected) 
          : ft;
    }).toList());
    ref.read(userNotifier.notifier).updateFollowedTopics(topicId, isSelected);
  }
}

方案二：使用Family Provider传入初始收藏ID（推荐） #

将FollowedTopicsNotifier改为Family Provider，在创建时传入用户初始收藏ID，彻底避免在build中依赖UserNotifier：

1. 定义Family Provider #

final followedTopicsProvider = AsyncNotifierProvider.family<
  FollowedTopicsNotifier, 
  List<FollowableTopic>, 
  List<String> // 泛型参数：传入的初始收藏ID列表
>((ref, initialFollowedIds) {
  return FollowedTopicsNotifier(initialFollowedIds);
});

2. 修改Notifier实现 #

class FollowedTopicsNotifier extends AsyncNotifier<List<FollowableTopic>> {
  final List<String> _initialFollowedIds;

  FollowedTopicsNotifier(this._initialFollowedIds);

  @override
  FutureOr<List<FollowableTopic>> build() async {
    final topics = await ref.watch(topicsRepository).fetchTopics();
    // 使用构造函数传入的初始ID生成列表
    final followedTopics = topics.map(
      (topic) => FollowableTopic(
        topic: topic,
        isFollowed: _initialFollowedIds.contains(topic.id)
      )
    ).toList();

    return followedTopics;
  }

  void updateTopics(String topicId, bool isSelected) {
    // 更新本地状态
    state = AsyncData(state.value!.map((ft) {
      return ft.topic.id == topicId 
          ? ft.copyWith(isFollowed: isSelected) 
          : ft;
    }).toList());
    // 同步更新UserNotifier的收藏状态
    ref.read(userNotifier.notifier).updateFollowedTopics(topicId, isSelected);
  }
}

3. 使用Provider时传入初始值 #

// 在需要使用的地方，从UserNotifier读取初始ID传入
ref.watch(followedTopicsProvider(ref.read(userNotifier).followedTopics));

方案三：使用ProviderScope注入初始值 #

如果你需要在特定路由/场景下注入初始值，可以通过ProviderScope的overrides功能实现：

1. 定义一个占位Provider #

// 定义一个用于提供初始收藏ID的占位Provider
final initialFollowedTopicsProvider = Provider<List<String>>((ref) {
  throw UnimplementedError("必须在ProviderScope中重写该Provider");
});

2. 修改Notifier实现 #

class FollowedTopicsNotifier extends AsyncNotifier<List<FollowableTopic>> {
  @override
  FutureOr<List<FollowableTopic>> build() async {
    final topics = await ref.watch(topicsRepository).fetchTopics();
    // 读取重写后的初始收藏ID
    final initialFollowedIds = ref.read(initialFollowedTopicsProvider);
    
    final followedTopics = topics.map(
      (topic) => FollowableTopic(
        topic: topic,
        isFollowed: initialFollowedIds.contains(topic.id)
      )
    ).toList();

    return followedTopics;
  }

  void updateTopics(String topicId, bool isSelected) {
    // 同方案二的更新逻辑
    state = AsyncData(state.value!.map((ft) {
      return ft.topic.id == topicId 
          ? ft.copyWith(isFollowed: isSelected) 
          : ft;
    }).toList());
    ref.read(userNotifier.notifier).updateFollowedTopics(topicId, isSelected);
  }
}

3. 在ProviderScope中重写占位Provider #

// 在用户登录后的页面路由中，用ProviderScope包裹
ProviderScope(
  overrides: [
    initialFollowedTopicsProvider.overrideWithValue(
      ref.read(userNotifier).followedTopics
    ),
  ],
  child: const FollowedTopicsPage(),
)

方案选择建议 #

• 优先选方案二：逻辑清晰，无需额外的Scope配置，直接通过Family Provider传递初始值，完全符合你的需求。
• 方案一适合简单场景，但需要确保用户状态在Notifier初始化前已准备好。
• 方案三适合复杂的路由级状态隔离场景。

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