Flutter应用终止状态下Firebase推送通知跳转指定页面问题

核心场景与回调说明 #

你用FirebaseMessaging.instance.getInitialMessage()处理应用终止状态的推送是正确的，导航失效并非需要替换成onSelectNotification，两者适用场景不同：

• getInitialMessage()：专门处理**应用完全终止（进程已杀死）**时，点击FCM系统推送启动应用的场景。
• onMessageOpenedApp.listen()：处理应用后台运行时点击推送的场景（你已正确实现）。
• onSelectNotification：属于flutter_local_notifications插件的回调，仅当你用该插件显示本地通知（包括前台接收FCM时转成本地通知显示）时，点击通知才会触发。

代码问题排查与修复 #

1. Navigator初始化时机问题 #

调用_handleMessage时，若MaterialApp未完成初始化，navigatorKey.currentState会是null（你用!强制解包会直接报错）。需延迟到UI初始化完成后执行导航：

FirebaseMessaging.instance.getInitialMessage().then((RemoteMessage? message) async {
  if (message != null) {
    // 等待UI帧绘制完成，确保Navigator已初始化
    WidgetsBinding.instance.addPostFrameCallback((_) {
      _handleMessage(message!);
    });
  }
});

同时确保MaterialApp已绑定全局navigatorKey：

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

MaterialApp(
  navigatorKey: navigatorKey,
  // 其他配置项
)

2. 数据判断逻辑错误 #

_handleMessage开头的条件存在空指针风险，message.data != null || message.data["entityid"] != null会在message.data为null时，直接触发message.data["entityid"]的访问错误，应改为：

if (message.data != null && message.data["entityid"] != null) {
  // 后续业务逻辑
}

3. SharedPreferences存值问题 #

代码中getIt<SharedPreferences>().setString('targetid', targetid);的targetid为null，而SharedPreferences不支持存储null值，需调整为：

if (targetid != null) {
  getIt<SharedPreferences>().setString('targetid', targetid);
} else {
  getIt<SharedPreferences>().remove('targetid'); // 或存储空字符串
}

onSelectNotification的正确用法（可选） #

若你通过flutter_local_notifications显示FCM通知（比如前台接收推送时弹出本地通知），需在插件初始化时设置该回调处理点击导航：

flutterLocalNotificationsPlugin.initialize(
  initializationSettings,
  onSelectNotification: (payload) async {
    if (payload != null) {
      // payload为显示通知时传入的推送数据（可将message.data转为JSON字符串）
      final Map<String, dynamic> data = jsonDecode(payload);
      // 复用_handleMessage逻辑或直接处理导航
      _handleMessage(RemoteMessage(data: data));
    }
  },
);

注意：应用终止状态下，只有点击本地通知才会触发此回调，仍需保留getInitialMessage的处理以覆盖FCM系统通知的场景。

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