Flutter Navigation 2.0+Bloc/Cubit下安卓返回键直接关闭APP求助

问题根源 #

你的应用采用嵌套Navigator + Cubit状态管理导航的架构，安卓返回键直接关闭应用的核心原因有两个：

1. 系统返回键默认只会通知最顶层的AppNavigator，而顶层Navigator的pages列表始终只有一个页面（如SwitchBoard），所以触发pop时直接关闭应用。
2. 子Navigator的onPopPage没有和Cubit的导航状态绑定，无法触发状态回退来更新页面列表。

分步解决方案 #

1. 给导航Cubit添加返回逻辑 #

每个用户组的导航Cubit需要维护导航栈状态，并提供pop方法来回退到上一个状态。

示例（Group1Cubit）：

class Group1Cubit extends Cubit<Group1State> {
  Group1Cubit() : super(Group1DashboardState());

  void showGroup1UserProfile() => emit(ProfileState());

  // 添加返回方法，处理状态回退
  void pop() {
    if (state is ProfileState) {
      emit(Group1DashboardState());
    }
    // 可根据业务需求扩展其他状态的回退逻辑
  }
}

2. 修改子Navigator的onPopPage逻辑 #

让子Navigator的onPopPage调用Cubit的pop方法，同步更新页面列表。

示例（UserGroup1Navigator）：

class UserGroup1Navigator extends StatelessWidget {
  // 给Navigator设置全局Key，方便后续判断是否可返回
  final GlobalKey<NavigatorState> navigatorKey = GlobalKey<NavigatorState>();

  @override
  Widget build(BuildContext context) {
    return BlocBuilder<Group1Cubit, Group1State>(builder: (context, state) {
      return Navigator(
        key: navigatorKey,
        pages: [
          if (state is Group1DashboardState)
            MaterialPage(
                key: const ValueKey('Group1Dashboard'),
                child: Group1Dashboard()),
          if (state is ProfileState)
            MaterialPage(
                key: const ValueKey('UserProfile'),
                child: UserProfile()),
          // ...其他页面
        ],
        onPopPage: (route, result) {
          if (!route.didPop(result)) return false;
          // 调用Cubit的pop方法回退状态
          context.read<Group1Cubit>().pop();
          return true;
        },
      );
    });
  }
}

3. 用WillPopScope拦截系统返回键 #

在SwitchBoard和AppNavigator中添加WillPopScope，优先让子导航处理返回逻辑，只有子导航无法返回时再处理顶层操作（如退出登录或关闭应用）。

修改SwitchBoard：

class SwitchBoard extends StatelessWidget {
  final String? userType;
  SwitchBoard({Key? key, this.userType}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return BlocBuilder<SessionCubit, SessionState>(builder: (context, state) {
      return WillPopScope(
        onWillPop: () async {
          // 获取当前子Navigator的状态
          final childNavigator = context.findAncestorStateOfType<NavigatorState>();
          if (childNavigator != null && childNavigator.canPop()) {
            // 子导航可返回，交给子导航处理
            childNavigator.pop();
            return false; // 阻止系统默认的pop操作
          } else {
            // 子导航已在首页，弹出确认退出登录对话框
            final shouldLogout = await showDialog(
              context: context,
              builder: (context) => AlertDialog(
                title: const Text('确认退出'),
                content: const Text('确定要退出登录吗？'),
                actions: [
                  TextButton(
                    onPressed: () => Navigator.pop(context, false),
                    child: const Text('取消'),
                  ),
                  TextButton(
                    onPressed: () => Navigator.pop(context, true),
                    child: const Text('确定'),
                  ),
                ],
              ),
            );
            if (shouldLogout == true) {
              context.read<SessionCubit>().logout();
            }
            return false;
          }
        },
        child: Navigator(
          pages: [
            if (userType == 'group1')
              MaterialPage(
                  child: BlocProvider(
                      create: (context) => Group1Cubit(
                          sessionCubit: context.read<SessionCubit>()),
                      child: UserGroup1Navigator())),
            if (userType == 'group2') MaterialPage(child: UserGroup2Navigator()),
            // ...其他用户组
          ],
          onPopPage: (route, result) => route.didPop(result),
        ),
      );
    });
  }
}

修改AppNavigator：

class AppNavigator extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return BlocBuilder<SessionCubit, SessionState>(builder: (context, state) {
      return WillPopScope(
        onWillPop: () async {
          if (state is UnauthenticatedState) {
            // 未登录状态下，点击返回键直接退出应用
            return true;
          }
          // 已登录状态下，交给SwitchBoard处理返回逻辑
          return false;
        },
        child: Navigator(
          pages: [
            if (state is UnknownSessionState)
              const MaterialPage(child: SplashScreen()),
            if (state is UnauthenticatedState)
              MaterialPage(
                  child: BlocProvider(
                create: (context) =>
                    AuthCubit(sessionCubit: context.read<SessionCubit>()),
                child: AuthNavigator(),
              )),
            if (state is AuthenticatedState)
              MaterialPage(
                  child: BlocProvider(
                create: (context) => SessionCubit(authRepo: AuthRepository()),
                child: SwitchBoard(userType: state.user!.type),
              )),
          ],
          onPopPage: (route, result) {
            if (!route.didPop(result)) return false;
            return true;
          },
        ),
      );
    });
  }
}

关键要点总结 #

• 每个导航Cubit必须维护导航状态栈，提供pop方法实现状态回退。
• 子Navigator的onPopPage要与Cubit绑定，确保页面列表随状态更新。
• 用WillPopScope拦截系统返回键，优先处理子导航的返回请求，避免顶层Navigator直接触发应用关闭。

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