Firebase推送通知点击跳转不稳定问题求助

核心问题分析 #

从提供的代码中，可定位出几个关键的时序与逻辑错误，这些是导致通知跳转行为不稳定的主要原因：

1. 通知初始化时机过晚 #

在main函数中，你先调用runApp启动应用，之后才初始化通知相关逻辑（pushNotificationToken、notificationActions），这会引发两个问题：

• 当App通过通知冷启动时，getInitialMessage的处理会滞后于App路由初始化，首页已加载完成，跳转逻辑被覆盖。
• 部分系统会在App启动完成前触发通知点击回调，此时通知监听仍未注册，导致回调丢失。

修复方案：
将通知初始化逻辑移到runApp之前，确保App启动前完成监听注册：

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  DartPluginRegistrant.ensureInitialized();
  await Firebase.initializeApp();
  await SharedPref.initialize();
  initilizeCamera();
  initializeDb();

  FlutterError.onError = (error) {
    FirebaseCrashlytics.instance.recordFlutterFatalError(error);
  };

  PlatformDispatcher.instance.onError = (error, stack) {
    FirebaseCrashlytics.instance.recordError(error, stack, fatal: true);
    return true;
  };

  // --- 通知初始化移至runApp前 ---
  await pushNotificationToken();
  await notificationActions(
    action: (RemoteMessage? message) {
      if (kDebugMode) {
        if (message?.notification != null) {}
      }
      if (message != null) {
        notificationAction(message: message);
      }
    },
    localNotification: true,
    localNotificationAction: (payload) {
      if (kDebugMode) {}
      notificationAction(payload: payload);
    });

  await SystemChrome.setPreferredOrientations([DeviceOrientation.portraitUp]);
  await SystemChrome.setSystemUIOverlayStyle(const SystemUiOverlayStyle(
    systemNavigationBarColor: Colors.white,
    statusBarColor: Colors.white,
  ));

  runApp(const ProviderScope(child: MyApp()));
}

2. 本地通知冷启动处理逻辑错误 #

在FlutterLocalNotificationHelper.initializeSettings中，冷启动通知的payload传递逻辑错误：

if (notificationAppLaunchDetails?.didNotificationLaunchApp ?? false) {
  await onSelectNotification(
    notificationAppLaunchDetails?.notificationResponse.toString(),
  );
}

此处传递的是notificationResponse的字符串形式，而非实际payload内容，导致解析失败，无法触发正确跳转。

修复方案：
直接传递notificationResponse的payload参数：

if (notificationAppLaunchDetails?.didNotificationLaunchApp ?? false) {
  final payload = notificationAppLaunchDetails?.notificationResponse?.payload;
  await onSelectNotification(payload);
}

3. 重复调用getInitialMessage #

main函数与notificationActions中均调用了await FirebaseMessaging.instance.getInitialMessage();，重复处理冷启动消息会引发逻辑冲突，导致部分跳转失效。

修复方案：
删除main函数中的重复调用，仅保留notificationActions内的处理逻辑。

4. 本地通知ID重复 #

在showNotificationWithDefaultSound中，固定使用0作为通知ID：

await _flutterLocalNotificationsPlugin.show(
  0, // 固定ID会覆盖旧通知
  title,
  body,
  platformChannelSpecifics,
  payload: payload,
);

多通知共存时，新通知会覆盖旧通知，点击旧通知无法获取正确payload。

修复方案：
使用唯一ID，比如时间戳：

await _flutterLocalNotificationsPlugin.show(
  DateTime.now().millisecondsSinceEpoch, // 生成唯一ID
  title,
  body,
  platformChannelSpecifics,
  payload: payload,
);

5. 路由跳转时机问题 #

notificationAction中的跳转逻辑可能在GetX路由未完全初始化时执行，导致跳转失败。建议确保路由就绪后再执行跳转：

void notificationAction({RemoteMessage? message, Map<String, dynamic>? payload}) {
  WidgetsBinding.instance.addPostFrameCallback((_) {
    // 此处编写你的跳转逻辑，例如：
    Get.toNamed('/target-page', arguments: payload);
  });
}

额外验证点 #

• 检查notificationAction中的payload解析逻辑，确保从RemoteMessage.data或本地通知payload中正确提取跳转参数，避免解析错误导致跳转失败。
• 确认AndroidManifest.xml与iOS的Info.plist已正确配置FCM相关权限与Intent Filter（Android端），避免系统层面拦截通知点击事件。

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