Flutter应用：点击推送通知跳转后按返回键进入空白页问题

核心原因 #

点击推送通知打开页面时，页面被加入了独立的导航栈（而非应用主导航栈），导致按返回键时没有上一级页面可回，从而出现空白页。

解决方案 #

1. 配置全局NavigatorKey #

在你的MaterialApp中设置全局导航键，确保通知跳转时使用应用主导航栈：

final GlobalKey<NavigatorState> navigatorKey = GlobalKey<NavigatorState>();

MaterialApp(
  navigatorKey: navigatorKey,
  // 其他页面路由、主题等配置
)

2. 修正通知点击跳转逻辑 #

处理推送通知的点击事件时，使用全局导航键打开目标页面，避免创建新的独立导航栈：

// 示例：Firebase Messaging 前台通知点击处理
FirebaseMessaging.onMessageOpenedApp.listen((RemoteMessage message) {
  navigatorKey.currentState?.pushNamed('/target-page', arguments: message.data);
});

// 后台通知点击处理（Android）
Future<void> _firebaseMessagingBackgroundHandler(RemoteMessage message) async {
  // 初始化必要服务后，通过全局导航键跳转
  navigatorKey.currentState?.pushNamed('/target-page', arguments: message.data);
}

3. 重写页面返回逻辑 #

在通知跳转的目标页面中，自定义返回键行为，确保返回时回到应用首页而非空白页：

// Flutter 3.10+ 使用PopScope
class TargetPage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return PopScope(
      canPop: false,
      onPopInvoked: (didPop) {
        if (!didPop) {
          // 直接返回首页并清空中间路由
          Navigator.of(context).pushAndRemoveUntil(
            MaterialPageRoute(builder: (context) => HomePage()),
            (route) => false,
          );
        }
      },
      child: Scaffold(/* 页面内容 */),
    );
  }
}

// 旧版本使用WillPopScope
class TargetPage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return WillPopScope(
      onWillPop: () async {
        Navigator.of(context).pushAndRemoveUntil(
          MaterialPageRoute(builder: (context) => HomePage()),
          (route) => false,
        );
        return false; // 阻止默认的返回栈行为
      },
      child: Scaffold(/* 页面内容 */),
    );
  }
}

4. 优化退出应用逻辑 #

如果你的退出对话框在首页弹出，确保退出时先清空导航栈再退出应用：

btnOkOnPress: () {
  // 先将导航栈清空到首页
  Navigator.of(context).popUntil((route) => route.isFirst);
  // 再退出应用
  SystemNavigator.pop();
},

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