Flutter页面跳转触发ProviderNotFoundException问题求助

问题描述 #

从WelcomeScreen点击“Get me in”按钮跳转至NavigationScreen时，抛出ProviderNotFoundException，其他页面跳转功能正常。

问题根源 #

1. WelcomePage中Bloc实例创建错误：在BlocBuilder中手动传入bloc: WelcomeBloc()，会创建独立于全局作用域的新Bloc实例，导致Bloc作用域混乱。
2. NavigationScreen的Bloc作用域不足：BottomNavigationCubit仅在home属性的MultiBlocProvider中提供，通过routes跳转的页面不在该作用域内，无法获取Cubit实例。

修复步骤 #

步骤1：修正WelcomePage的BlocBuilder使用 #

移除BlocBuilder中的bloc参数，让它自动从上下文获取全局MultiBlocProvider提供的WelcomeBloc实例：

// WelcomeScreen.dart
@override
Widget build(BuildContext context) {
  // 移除bloc: WelcomeBloc()参数
  return BlocBuilder<WelcomeBloc, WelcomeState>(
    builder: (context, state) {
      // 原有Scaffold等代码保持不变
      return Scaffold(...);
    },
  );
}

步骤2：提升MultiBlocProvider的作用域 #

将MultiBlocProvider移至MaterialApp外层，确保所有路由页面都处于Bloc的作用域内：

// main.dart
@override
Widget build(BuildContext context) {
  return MultiBlocProvider(
    providers: [
      BlocProvider<ProfileScreenBloc>(
        create: (BuildContext context) => ProfileScreenBloc(),
      ),
      BlocProvider<BottomNavigationCubit>(
          create: (BuildContext context) => BottomNavigationCubit()),
      BlocProvider<HomeBloc>(
        create: (BuildContext context) => HomeBloc(),
      ),
      BlocProvider<WelcomeBloc>(
          create: (BuildContext context) => WelcomeBloc())
    ],
    child: MaterialApp(
      debugShowCheckedModeBanner: false,
      theme: ThemeData(fontFamily: 'Roboto'),
      home: Builder(
        builder: (BuildContext context) {
          SizeConfig().initState(context);
          return WelcomePage();
        },
      ),
      routes: getRoutes(),
    ),
  );
}

步骤3：移除NavigationScreen中的全局变量 #

全局变量_selectedIndex会导致状态异常，直接使用Bloc中的状态管理即可：

// NavigationScreen.dart
// 删除全局变量：int _selectedIndex = 0;
// 删除无用方法：void _onTappedItem(index) { ... }

@override
Widget build(BuildContext context) {
  return Scaffold(
    bottomNavigationBar: BlocBuilder<BottomNavigationCubit, BottomNavigationState>(
      builder: (context, state) {
        return BottomNavigationBar(
          currentIndex: state.selectedIndex,
          // 原有BottomNavigationBar配置保持不变
        );
      },
    ),
    // 原有body部分代码保持不变
  );
}

修复逻辑说明 #

• 提升MultiBlocProvider到MaterialApp外层后，所有通过routes跳转的页面都能访问到全局Bloc/Cubit实例，解决ProviderNotFoundException问题。
• 移除手动创建的Bloc实例，确保使用全局统一的Bloc实例，避免作用域冲突。
• 依赖Bloc管理底部导航状态，删除全局变量，符合状态管理规范，避免状态不一致问题。

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