Flutter Bloc状态管理应用卡在启动页，路由监听异常

1. 确认BlocListener的监听范围 #

• 把BlocListener<RouteCubit, RouteState>挂载到导航上下文的上层（比如MaterialApp外层），如果放在启动页内部，状态变化时启动页上下文可能已被移除，导致监听失效。示例代码：

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return BlocProvider(
      create: (_) => RouteCubit(),
      child: BlocListener<RouteCubit, RouteState>(
        listener: (context, state) {
          if (state is TargetRouteState) {
            Navigator.of(context).pushReplacementNamed(AppRoutes.targetPage);
          }
        },
        child: MaterialApp(
          initialRoute: AppRoutes.splash,
          routes: AppRoutes.routes,
          navigatorObservers: [AppNavigatorObserver()],
        ),
      ),
    );
  }
}

2. 验证RouteCubit的状态派发逻辑 #

• Bloc基于状态实例对比触发监听，确保状态类重写==和hashCode，且每次emit新的状态实例：

// 状态类示例
class TargetRouteState extends RouteState {
  final String routeName;

  TargetRouteState(this.routeName);

  @override
  bool operator ==(Object other) =>
      identical(this, other) ||
      other is TargetRouteState &&
          runtimeType == other.runtimeType &&
          routeName == other.routeName;

  @override
  int get hashCode => routeName.hashCode;
}

// Cubit中emit新状态
void navigateToTarget() {
  emit(TargetRouteState(AppRoutes.targetPage));
}

3. 修正导航跳转方法 #

• 启动页跳转优先用pushReplacementNamed或pushAndRemoveUntil，避免启动页留在导航栈中：

// 替换启动页，清空旧栈
Navigator.of(context).pushReplacementNamed(AppRoutes.targetPage);

// 或者完全清空栈，只保留目标页
Navigator.of(context).pushAndRemoveUntil(
  MaterialPageRoute(builder: (_) => TargetPage()),
  (route) => false,
);

4. 完善AppNavigatorObserver的日志 #

• pushReplacementNamed会触发didReplace而非didPush，补充对应方法的日志输出：

class AppNavigatorObserver extends NavigatorObserver {
  @override
  void didPush(Route<dynamic> route, Route<dynamic>? previousRoute) {
    super.didPush(route, previousRoute);
    print('didPush: ${route.settings.name}');
  }

  @override
  void didReplace({Route<dynamic>? newRoute, Route<dynamic>? oldRoute}) {
    super.didReplace(newRoute: newRoute, oldRoute: oldRoute);
    print('didReplace: ${newRoute?.settings.name}');
  }
}

5. 检查BlocProvider的作用域 #

• 确保RouteCubit的Provider是全局或导航树上层，避免启动页销毁时Cubit被回收，导致状态变化无法被监听。

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