Riverpod中仅刷新calendarProvider却触发多Provider重复请求的问题

问题核心原因 #

你遇到的问题本质是：ParentHeader Provider的构建逻辑会在它依赖的任意子Provider失效时，完整重新执行一遍。当你调用invalidate(calendarProvider)时，ParentHeader因为通过ref.watch绑定了这个子Provider，会触发自身的重新build，进而重新执行parentHeader方法。方法里的tasks、video、calendar三个Future都是通过ref.watch(...future)创建的，所以每次方法执行都会重新发起这三个请求。而trialProvider没有重复调用，是因为它的缓存还处于有效状态，await ref.watch(trialProvider.future)直接返回了缓存值，没有触发新的API请求。

解决方案：拆分依赖逻辑，避免连带触发 #

要实现仅刷新calendarProvider的需求，需要把三个子Provider的依赖逻辑拆解开，不让一个子Provider的失效导致所有请求重跑。以下是两种可行方案：

方案一：将三个子Provider状态单独托管，按需刷新

修改ParentHeader的逻辑，让它分别持有三个子Provider的状态，而非一次性等待所有Future。这样当你仅invalidate calendarProvider时，只有对应状态会更新，不会触发另外两个请求。

示例代码：

@riverpod
class ParentHeader extends _$ParentHeader {
  @override
  FutureOr<Map<String, dynamic>> build(HeaderViewModel viewModel) async {
    final trial = await ref.watch(trialProvider.future);
    if (trial == null) return {};

    // 初始加载三个子Provider的数据
    final tasks = await ref.watch(tasksProvider(viewModel.strStartDate, viewModel.strEndDate).future);
    final video = await ref.watch(videoProvider(viewModel.tmpStartDate, viewModel.tmpEndDate).future);
    final calendar = await ref.watch(calendarProvider(viewModel.strStartDate, viewModel.strEndDate).future);

    return {
      'tasks': tasks,
      'video': video,
      'calendar': calendar,
    };
  }

  // 单独提供刷新calendar的方法
  Future<void> refreshCalendar(HeaderViewModel viewModel) async {
    await ref.invalidate(calendarProvider(viewModel.strStartDate, viewModel.strEndDate));
  }
}

调用refreshCalendar时，只有calendarProvider会重新执行，ParentHeader的状态仅更新calendar部分，tasks和video的缓存会被保留，不会触发新的API请求。

方案二：用ref.listen单独监听calendarProvider变化

如果不需要把三个数据都放在ParentHeader的状态里，可以用ref.listen单独监听calendarProvider的变化，这样其他Provider的请求不会因calendar失效而重跑。

示例代码：

@riverpod
class ParentHeader extends _$ParentHeader {
  @override
  FutureOr<bool> build(HeaderViewModel viewModel) async {
    final trial = await ref.watch(trialProvider.future);
    if (trial == null) return false;

    // 仅在首次构建时加载tasks和video，后续除非自身依赖变化，否则不会重跑
    await ref.watch(tasksProvider(viewModel.strStartDate, viewModel.strEndDate).future);
    await ref.watch(videoProvider(viewModel.tmpStartDate, viewModel.tmpEndDate).future);

    // 监听calendarProvider的更新，按需处理后续逻辑
    ref.listen(calendarProvider(viewModel.strStartDate, viewModel.strEndDate), (previous, next) {
      // 这里可以处理calendar数据更新后的业务逻辑
    });

    // 初始加载calendar数据
    await ref.watch(calendarProvider(viewModel.strStartDate, viewModel.strEndDate).future);
    return true;
  }

  Future<void> refreshCalendar(HeaderViewModel viewModel) async {
    await ref.invalidate(calendarProvider(viewModel.strStartDate, viewModel.strEndDate));
  }
}

这种方式下，tasks和video的请求只会在ParentHeader首次构建时执行，后续即使calendarProvider失效，也不会触发这两个请求的重跑。

额外注意事项 #

• 确保子Provider（如calendarProvider）的参数是稳定的，避免因参数变化导致不必要的重建。
• Riverpod默认的缓存机制会保留未失效Provider的状态，我们通过拆分依赖，利用这一特性避免了连带请求。

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