Flutter本地通知iOS端点击无法跳转指定页面如何解决

问题根因 #

iOS端和Android端的通知回调触发逻辑存在差异，主要有两个常见触发场景未适配：

• 应用完全杀死（terminated状态）时点击通知启动，默认不会直接触发onSelectNotification回调
• 旧版本flutter_local_notifications的iOS初始化未配置前台通知接收回调，跳转逻辑无法执行

具体调整步骤 #

1. 补充iOS初始化回调配置 #

初始化IOSInitializationSettings时补充onDidReceiveLocalNotification参数，适配iOS端前台接收通知的场景。

2. 适配冷启动通知跳转逻辑 #

初始化完成后主动获取启动时携带的通知信息，处理完全杀死状态下点击通知的跳转需求。

3. 确保通知权限已申请 #

你当前初始化配置中关闭了权限自动申请，需要在业务合适的时机主动触发iOS通知权限申请，否则无法收到通知。

4. 优化跳转Context有效性 #

冷启动场景下回调触发时页面可能还未完成挂载，需要等待帧渲染完成后再执行跳转，避免context无效导致跳转失败。 #

修改后完整代码示例 #

Future<void> initSettings() async {
  var initAndroid = AndroidInitializationSettings('my_logo');
  var initIOS = IOSInitializationSettings(
    requestSoundPermission: false,
    requestBadgePermission: false,
    requestAlertPermission: false,
    // 补充iOS前台通知接收回调
    onDidReceiveLocalNotification: onDidReceiveLocalNotification,
  );
  var initSetting = InitializationSettings(android: initAndroid, iOS: initIOS);
  notificationsPlugin = FlutterLocalNotificationsPlugin();
  await notificationsPlugin.initialize(initSetting,
      onSelectNotification: notificationSelected);
  
  // 新增：处理冷启动点击通知的场景
  final notificationAppLaunchDetails = await notificationsPlugin.getNotificationAppLaunchDetails();
  if (notificationAppLaunchDetails?.didNotificationLaunchApp ?? false) {
    final payload = notificationAppLaunchDetails?.payload;
    notificationSelected(payload);
  }

  // 可选：如果还没申请权限，在此处主动触发权限申请
  await notificationsPlugin.resolvePlatformSpecificImplementation<IOSFlutterLocalNotificationsPlugin>()
    ?.requestPermissions(
      alert: true,
      badge: true,
      sound: true,
    );
}

// 新增iOS前台通知回调方法
void onDidReceiveLocalNotification(int id, String? title, String? body, String? payload) async {
  // 前台收到通知时可以自定义弹窗，或者直接触发跳转逻辑
  notificationSelected(payload);
}

Future notificationSelected(String? payload) async {
  // 优化：等待页面渲染完成后再跳转，避免context无效
  WidgetsBinding.instance.addPostFrameCallback((_) async {
    await Navigator.push(
      context,
      MaterialPageRoute(builder: (context) => SpesificScreen())
    );
  });
}

额外配置检查 #

检查iOS项目Info.plist文件中是否已添加以下配置，缺少会导致通知功能异常：

<key>NSUserNotificationsUsageDescription</key>
<string>需要通知权限向您推送消息</string>
<key>UIBackgroundModes</key>
<array>
  <string>remote-notification</string>
</array>

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