已存在Provider却触发ProviderNotFoundException的BLOC问题求助

问题场景 #

在新项目中实现BLoC时，使用BlocProvider包裹BlocBuilder的代码在其他项目可正常运行，但当前项目抛出ProviderNotFoundException，报错提示找不到对应的Provider。

代码示例 #

Widget _buildEvents() {
  return BlocProvider<EventBloc>(
    create: (_) => EventBloc(),
    child: BlocBuilder(
      builder: (context, state) {
        return Container();
      },
    ),
  );
}

报错信息 #

The following ProviderNotFoundException was thrown building _InheritedProviderScope<EventBloc?>(value: ):
Error: Could not find the correct Provider<StateStreamable<Object?>> above this BlocBuilder<StateStreamable<Object?>, Object?> Widget
...（省略后续提示内容）

问题原因 #

当前BlocBuilder使用的context是_buildEvents方法的上下文，这个上下文是BlocProvider的父级上下文，还没有包含刚创建的EventBloc实例，所以BlocBuilder无法从该上下文中找到对应的Provider。

另外，未明确指定BlocBuilder的泛型参数（EventBloc和对应的State类型），导致Flutter推断出的类型与实际Provider类型不匹配，加重了这个问题。

修复方案 #

方案1：通过Builder获取子上下文

新增一个Builder组件，使用Builder提供的子上下文来构建BlocBuilder，这个上下文会包含BlocProvider注入的EventBloc：

Widget _buildEvents() {
  return BlocProvider<EventBloc>(
    create: (_) => EventBloc(),
    child: Builder(
      builder: (context) {
        return BlocBuilder<EventBloc, EventState>(
          builder: (context, state) {
            return Container();
          },
        );
      },
    ),
  );
}

方案2：直接指定Bloc实例

在BlocBuilder中通过context.read获取Bloc实例，跳过上下文查找的问题：

Widget _buildEvents() {
  return BlocProvider<EventBloc>(
    create: (_) => EventBloc(),
    child: BlocBuilder<EventBloc, EventState>(
      bloc: context.read<EventBloc>(),
      builder: (context, state) {
        return Container();
      },
    ),
  );
}

额外排查点 #

• 确保EventBloc正确继承自Bloc或Cubit，且状态流逻辑正常
• 如果是添加Provider后执行了hot-reload，尝试执行hot-restart（报错提示中提到的场景）
• 检查是否存在路由跳转后上下文失效的情况（当前场景下大概率不涉及，但可作为通用排查项）

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