Flutter Riverpod的family如何为ChangeNotifierProvider传递多个参数

方案1：封装自定义参数类（通用扩展方案） #

Riverpod 的 family 修饰器本身仅支持传递单个参数，需要传递多个参数时，把所有参数打包封装为一个不可变的自定义类即可，后续新增参数直接在类中扩展属性就行。
需要注意必须重写参数类的 == 和 hashCode 方法（也可以直接用 freezed 自动生成），否则 family 会无法正确缓存 Provider 实例，导致不必要的重复重建。

// 1. 定义封装所有参数的不可变类
class RestaurantProviderParams {
  final BuildContext context;
  final Restaurant? restaurant;
  // 后续新增参数直接在此处添加属性即可

  const RestaurantProviderParams({
    required this.context,
    required this.restaurant,
  });

  // 必须重写 == 和 hashCode 保证 family 缓存正常
  @override
  bool operator ==(Object other) =>
      identical(this, other) ||
      other is RestaurantProviderParams &&
          runtimeType == other.runtimeType &&
          context == other.context &&
          restaurant == other.restaurant;

  @override
  int get hashCode => context.hashCode ^ restaurant.hashCode;
}

// 2. 修改 provider 定义，参数类型替换为自定义封装类
final restaurantProvider = ChangeNotifierProvider.family<RestaurantNotifier, RestaurantProviderParams>(
  (ref, params) => RestaurantNotifier(
    context: params.context,
    restaurant: params.restaurant,
  ),
);

// 3. 组件中使用时传入封装好的参数对象
final notifier = ref.watch(restaurantProvider(RestaurantProviderParams(
  context: context,
  restaurant: 当前的Restaurant实例,
)));

方案2：优化实现，移除BuildContext依赖（更符合Riverpod设计规范） #

你传递BuildContext的核心需求是读取其他Provider的状态，这个场景完全不需要依赖BuildContext，直接用Provider自带的ref即可读取所有其他Provider的状态，还能避免BuildContext失效导致的异常问题，性能更稳定。
优化后的代码如下：

// provider 定义，仅需要传递Restaurant参数即可
final restaurantProvider = ChangeNotifierProvider.family<RestaurantNotifier, Restaurant?>(
  (ref, restaurant) => RestaurantNotifier(
    ref: ref,
    restaurant: restaurant,
  ),
);

class RestaurantNotifier extends ChangeNotifier {
  final Ref ref;
  final Restaurant? restaurant;
  Placemark? placemark;
  bool isSaved = false;

  RestaurantNotifier({
    required this.ref,
    required this.restaurant,
  }) {
    getPlaceMark(restaurant);
    checkIsSaved(restaurant?.id);
  }

  getPlaceMark(Restaurant? restaurant) async {
    if (restaurant?.latitude != null && restaurant?.longitude != null) {
      List<Placemark> placemarkData = await LocationHelper.getPlaceMark(
        lat: double.parse(restaurant!.latitude!),
        long: double.parse(restaurant.longitude!),
      );
      placemark = placemarkData[0];
      notifyListeners();
    }
  }

  checkIsSaved(int? id) {
    // 直接用ref读取其他provider，不需要BuildContext
    final savedRestaurantsId = ref.read(savedRestaurantsIdProvider.state);
    isSaved = savedRestaurantsId.state.contains(id);
    notifyListeners();
  }
}

注意事项 #

• 封装的参数类所有属性必须用final修饰，保证不可变
• 非必要场景不要把BuildContext传入Notifier内部，避免上下文销毁导致的空异常
• 如果后续需要传入更多UI层的动态参数，直接在方案1的封装类中扩展属性即可，不需要修改核心逻辑

内容的提问来源于stack exchange，提问作者Golam Sarwar Shakil