Flutter报错ProviderNotFoundException：无法在HomePage组件上方找到EntryProvider

核心原因 #

ProviderNotFoundException本质是你调用读取Provider方法的BuildContext对应的Widget节点，不在你注册的EntryProvider的覆盖子树范围内。

常见问题排查点 #

• 你没有将EntryProvider注册在HomePage的父级节点中。Provider仅对它所在节点的下层子树生效，如果你把Provider放在HomePage同级、甚至HomePage的子节点中，HomePage的context是无法读取到对应Provider的。
• 注册Provider时未显式声明泛型类型。如果你注册时写的是ChangeNotifierProvider(create: (_) => EntryProvider())，没有加<EntryProvider>泛型，读取时指定了EntryProvider类型会出现类型匹配失败的问题。
• 读取和注册Provider用了同一个context。如果你在注册Provider的同一个build方法里直接用当前context读取Provider，此时当前context还没有包含你刚注册的Provider实例，会查找失败。

正确实现示例 #

方案1：在应用根节点注册（全局使用场景） #

void main() {
  runApp(
    // 注册时显式声明泛型类型
    ChangeNotifierProvider<EntryProvider>(
      create: (context) => EntryProvider(),
      child: const MyApp(),
    ),
  );
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      // HomePage处于Provider的子树内，可正常读取
      home: const HomePage(),
    );
  }
}

方案2：在当前页面注册（仅当前页面使用场景） #

如果你只需要在HomePage内使用EntryProvider，注册时需要用Builder包裹读取逻辑，拿到Provider下层的context：

class HomePage extends StatelessWidget {
  const HomePage({super.key});

  @override
  Widget build(BuildContext context) {
    return ChangeNotifierProvider<EntryProvider>(
      create: (context) => EntryProvider(),
      // Builder生成的context处于Provider下层，可正常读取
      child: Builder(
        builder: (childContext) {
          final entryProvider = childContext.read<EntryProvider>();
          return Scaffold(
            // 页面业务代码
          );
        },
      ),
    );
  }
}

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