Flutter中Firebase推送通知在App终止状态下点击路由跳转异常

问题场景 #

已在支持登录的App中集成Firebase推送通知，用户登录后进入首页，重启App仍保持登录状态。需要处理App终止状态下点击推送通知的事件，引导用户到指定路由，但目前点击通知总是跳转到初始路由/（对应InitHelper），尝试用getInitialMessage()跳转/home也未生效，实际需求是根据消息内容跳转到不同特定路由。

现有代码 #

FirebaseMessaging.instance.getInitialMessage().then((initialMessage) {
  if (initialMessage != null) {
    Get.toNamed('/home');
  }
});

List<GetPage> buildRoutes = [
  GetPage(
    name: '/',
    page: () => InitHelper(),
  ),
  GetPage(
    name: '/auth',
    page: () => InitialScreen(),
    transition: Transition.fadeIn,
  ),
  GetPage(
    name: '/home',
    page: () => TabsPage(selectedIndex: 0),
    transition: Transition.fadeIn,
  ),
];

@override
Widget build(BuildContext context) {
  return ScreenUtilInit(
      designSize: const Size(375, 812),
      builder: (context, _) {
        return GetMaterialApp(
          debugShowCheckedModeBanner: false,
          title: 'App Name',
          initialRoute: '/',
          getPages: buildRoutes,
        );
      });
}

解决方案 #

1. 延迟执行推送回调，确保Get框架初始化完成 #

当前代码可能在Get框架未完成初始化时就调用了Get.toNamed，导致跳转失效。需要把推送回调放在GetMaterialApp初始化完成后执行，比如在InitHelper的initState中结合WidgetsBinding延迟执行：

@override
void initState() {
  super.initState();
  WidgetsBinding.instance.addPostFrameCallback((_) {
    FirebaseMessaging.instance.getInitialMessage().then((initialMessage) {
      if (initialMessage != null) {
        // 用offAllNamed替换toNamed，清除初始路由栈，避免叠加
        Get.offAllNamed('/home');
      }
    });
  });
}

2. 整合登录状态与推送跳转逻辑 #

初始路由/对应的InitHelper应该负责统筹登录状态判断和推送跳转，避免两者逻辑冲突：

• 优先检查是否有推送初始化消息，有则优先处理跳转；
• 无推送消息时，再按登录状态自动跳转首页或登录页。

示例修改InitHelper：

class InitHelper extends StatefulWidget {
  @override
  _InitHelperState createState() => _InitHelperState();
}

class _InitHelperState extends State<InitHelper> {
  @override
  void initState() {
    super.initState();
    _handleRouteLogic();
  }

  void _handleRouteLogic() async {
    // 1. 先获取初始推送消息
    final initialMessage = await FirebaseMessaging.instance.getInitialMessage();
    // 2. 读取本地存储的登录状态
    bool isLoggedIn = await _checkLoginStatus();

    if (initialMessage != null) {
      // 从消息data中解析目标路由，比如message.data['target_route']
      String targetRoute = initialMessage.data['route'] ?? '/home';
      Get.offAllNamed(targetRoute);
    } else {
      // 无推送时按登录状态跳转
      Get.offAllNamed(isLoggedIn ? '/home' : '/auth');
    }
  }

  Future<bool> _checkLoginStatus() {
    // 实现登录状态检查逻辑，比如从SharedPreferences读取
    return Future.value(true);
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(body: Center(child: CircularProgressIndicator()));
  }
}

3. 确认Firebase推送配置完整性 #

• Android端：确保google-services.json配置正确，推送消息携带click_action: FLUTTER_NOTIFICATION_CLICK字段；
• iOS端：确认GoogleService-Info.plist已添加，APNs配置开启通知权限，推送消息的aps字段包含alert内容；
• 推送消息的data字段需正确携带路由标识，方便解析跳转目标。

4. 测试注意事项 #

• 测试终止状态推送时，需完全杀死App（不是后台挂起）；
• 在getInitialMessage回调中添加日志，确认回调是否触发；
• 确保测试设备能正常接收推送通知。

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