Flutter限制Navigator.push仅跳转一次 解决Firebase通知重复跳转问题

针对你遇到的问题，这里提供几个可行的解决方案，帮你限制跳转只执行一次：

1. 检查页面栈，避免重复跳转 #

在跳转前先遍历Navigator的页面栈，判断目标页面是否已经存在。如果存在，直接将该页面切换到栈顶；如果不存在，再执行push操作。

示例代码：

void navigateToTargetPage(BuildContext context) {
  // 目标页面的路由名称，根据你的实际配置调整
  const targetRouteName = '/targetPage';
  bool isPageExist = false;
  
  // 遍历栈，找到目标页面则停在该页面
  Navigator.of(context).popUntil((route) {
    if (route.settings.name == targetRouteName) {
      isPageExist = true;
      return true;
    }
    return false;
  });
  
  if (!isPageExist) {
    Navigator.of(context).push(MaterialPageRoute(
      builder: (context) => TargetPage(),
      settings: const RouteSettings(name: targetRouteName),
    ));
  }
}

2. 添加跳转锁，防止重复触发 #

设置一个全局布尔变量作为锁，当开始跳转时将锁设为true，跳转完成后再设为false，避免同一时间多次触发跳转操作。

示例代码：

bool _isNavigating = false;

void handleNotificationTap(BuildContext context) {
  if (_isNavigating) return;
  
  _isNavigating = true;
  Navigator.of(context).push(MaterialPageRoute(builder: (context) => TargetPage()))
    .whenComplete(() {
      _isNavigating = false;
    });
}

注意锁变量要保证在通知处理的实例中唯一，避免多个实例导致锁失效。

3. 优化Firebase通知点击事件的处理 #

确保每次通知点击事件只被处理一次。可以通过标记通知ID的方式，避免同一通知被重复响应。

示例代码（基于firebase_messaging）：

final FirebaseMessaging _firebaseMessaging = FirebaseMessaging.instance;

void initNotificationHandler(BuildContext context) {
  FirebaseMessaging.onMessageOpenedApp.listen((RemoteMessage message) {
    final String? notificationId = message.messageId;
    if (notificationId == null) return;
    
    // 用SharedPreferences存储已处理的通知ID
    SharedPreferences.getInstance().then((prefs) {
      if (prefs.containsKey(notificationId)) return;
      
      prefs.setString(notificationId, DateTime.now().toString());
      handleNotificationTap(context);
    });
  });
}

你之前尝试的pushReplacement失效，大概率是因为每次点击时栈顶不是目标页面，替换操作只是替换了当前栈顶页面，无法阻止多次点击生成新页面。结合上面的方案，应该能解决页面栈堆积的问题。

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