从Provider迁移至Riverpod遇报错：ChangeNotifierProvider不是函数

1. 确认依赖配置 #

先确保你在pubspec.yaml中添加了Riverpod的官方依赖：

dependencies:
  flutter_riverpod: ^2.3.0 # 建议使用最新稳定版本

执行flutter pub get完成依赖安装。

2. 全局声明Riverpod Provider #

Riverpod要求全局定义Provider实例，而非像原生Provider那样在MultiProvider内临时创建。针对你的UserProvider（需继承ChangeNotifier），在main.dart顶部全局范围声明：

// 全局声明，放在main函数之外
final userProvider = ChangeNotifierProvider((ref) => UserProvider());

这里的ChangeNotifierProvider是Riverpod提供的类，和原生Provider的同名函数完全不是同一个东西，这也是你报错的核心原因。

3. 替换MultiProvider为ProviderScope #

Riverpod用ProviderScope作为应用的根状态容器，替代原生Provider的MultiProvider。修改你的main函数：

void main() async {
  await Hive.initFlutter();
  await Hive.openBox("Habit_Database");

  // 用ProviderScope包裹应用，无需再用MultiProvider
  runApp(const ProviderScope(child: MyApp()));
}

4. 在Widget中使用状态 #

原来用Provider.of或Consumer的地方，换成Riverpod的用法：

// 方式1：用Consumer组件监听状态变化
Consumer(
  builder: (context, ref, child) {
    final userState = ref.watch(userProvider);
    return Text(userState.someProperty);
  },
)

// 方式2：触发状态更新（比如按钮点击）
onPressed: () {
  ref.read(userProvider.notifier).updateSomeState();
}

报错根源说明 #

原生Provider的ChangeNotifierProvider是用于在MultiProvider中注册的函数，但Riverpod的设计逻辑完全不同：它要求先全局声明Provider对象，再通过ProviderScope提供全局状态容器，两者API没有兼容性，直接照搬原生Provider的写法必然报错。

内容的提问来源于stack exchange，提问作者pomoworko.com