如何检查Home页面是否存在于NavigatorStack中，避免pop黑屏

要避免因执行popUntil时目标路由不存在导致的黑屏问题，你可以通过以下两种方式先判断Home页面是否在导航栈中：

方法一：遍历导航栈历史记录 #

直接检查Navigator的路由历史列表，判断是否存在目标路由名称：

// 定义方法判断Home页面是否在栈中
bool isHomePageInStack() {
  return navigatorKey.currentState?.history.any(
    (route) => route.settings.name == RouteUtil.ROUTE_HOME
  ) ?? false;
}

// 使用示例
if (isHomePageInStack()) {
  navigatorKey.currentState!.popUntil(ModalRoute.withName(RouteUtil.ROUTE_HOME));
}

说明 #

• navigatorKey.currentState?.history会返回当前导航栈的所有路由列表
• 通过any方法遍历列表，检查是否有路由的settings.name匹配Home页面的路由名称
• 若导航栈为空或未找到目标路由，方法会返回false，避免执行pop操作

方法二：通过popUntil遍历（不执行实际pop） #

利用popUntil的遍历特性，仅检查目标路由是否存在，不修改导航栈：

bool isHomePageInStack() {
  bool hasHomeRoute = false;
  navigatorKey.currentState?.popUntil((route) {
    if (route.settings.name == RouteUtil.ROUTE_HOME) {
      hasHomeRoute = true;
    }
    return true; // 返回true表示不停止遍历，继续检查所有路由
  });
  return hasHomeRoute;
}

// 使用示例
if (isHomePageInStack()) {
  navigatorKey.currentState!.popUntil(ModalRoute.withName(RouteUtil.ROUTE_HOME));
}

注意事项 #

• 确保Home页面在注册路由时，已正确设置settings.name为RouteUtil.ROUTE_HOME，否则无法通过名称匹配
• 若你的项目中使用了匿名路由（未设置name），则需要通过路由的runtimeType等其他标识来判断，比如：

  route is HomePageRoute // 假设Home页面的路由类是HomePageRoute
  

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