Flutter后台点击本地通知无法跳转页面的问题排查

核心错误点 #

你遇到的断言错误直接指向两个关键问题：

1. 本地通知的后台点击回调绑定了错误的函数——你把onDidReceiveBackgroundNotificationResponse指向了Firebase消息的后台处理函数firebaseMessagingBackgroundHandler，但这个函数的参数是RemoteMessage，和本地通知回调要求的NotificationResponse类型完全不匹配，逻辑上也毫无关联。
2. 你自己定义了正确的本地通知后台回调localNotificationBackground，但没有将其绑定到插件初始化参数中。
3. flutterLocalNotificationsPlugin.initialize被放在localNotification函数内，每次收到消息都会重复初始化，可能导致回调绑定失效。

具体修复步骤 #

1. 调整初始化时机，绑定正确的后台回调 #

把本地通知的初始化移到App启动阶段（比如main函数），只执行一次，并正确绑定回调：

// 全局定义本地通知实例
FlutterLocalNotificationsPlugin flutterLocalNotificationsPlugin = FlutterLocalNotificationsPlugin();

// 全局导航键，用于后台跳转页面时获取导航上下文
final GlobalKey<NavigatorState> navigatorKey = GlobalKey<NavigatorState>();

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  // 初始化Firebase（按需保留）
  await Firebase.initializeApp(options: DefaultFirebaseOptions.currentPlatform);
  
  // 初始化本地通知
  await _initLocalNotifications();
  
  runApp(MyApp(navigatorKey: navigatorKey));
}

Future<void> _initLocalNotifications() async {
  const AndroidInitializationSettings initializationSettingsAndroid =
      AndroidInitializationSettings("@drawable/notification_icon");
  const InitializationSettings initializationSettings =
      InitializationSettings(android: initializationSettingsAndroid);
  
  // 绑定正确的前后台回调
  await flutterLocalNotificationsPlugin.initialize(
    initializationSettings,
    onDidReceiveNotificationResponse: _handleForegroundNotificationClick,
    // 直接传递顶层函数引用，不要用箭头函数包裹
    onDidReceiveBackgroundNotificationResponse: localNotificationBackground,
  );
  
  // 提前创建通知通道，无需每次收到消息都创建
  const AndroidNotificationChannel channel = AndroidNotificationChannel(
    "local_notification",
    "本地通知",
    description: "本地通知专用通道",
    importance: Importance.max,
    playSound: true,
  );
  await flutterLocalNotificationsPlugin
      .resolvePlatformSpecificImplementation<AndroidFlutterLocalNotificationsPlugin>()
      ?.createNotificationChannel(channel);
}

2. 完善后台回调函数，实现页面跳转 #

后台环境无法直接获取组件上下文，需用全局导航键完成页面跳转：

@pragma('vm:entry-point')
Future<void> localNotificationBackground(NotificationResponse details) async {
  print("后台点击本地通知，payload: ${details.payload}");
  
  // 延迟确保App页面栈初始化完成（可选）
  await Future.delayed(const Duration(milliseconds: 500));
  
  // 跳转到目标页面，替换成你的路由路径
  navigatorKey.currentState?.pushNamed(
    "/booking_detail",
    arguments: details.payload, // 传递payload数据，比如booking_id
  );
}

// 前台点击通知的处理函数
void _handleForegroundNotificationClick(NotificationResponse details) {
  navigatorKey.currentState?.pushNamed(
    "/booking_detail",
    arguments: details.payload,
  );
}

3. 简化通知显示逻辑，移除重复初始化 #

现在localNotification只负责显示通知即可：

Future<void> localNotification(RemoteMessage message) async {
  await FirebaseMessaging.instance.setForegroundNotificationPresentationOptions(
    alert: true,
    badge: true,
    sound: true,
  );
  
  RemoteNotification? notification = message.notification;
  AndroidNotification? android = message.notification?.android;
  if (notification != null && android != null) {
    await flutterLocalNotificationsPlugin.show(
      notification.hashCode,
      notification.title,
      notification.body,
      NotificationDetails(
        android: AndroidNotificationDetails(
          "local_notification",
          "本地通知",
          channelDescription: "本地通知专用通道",
          importance: Importance.max,
          playSound: true,
          color: Colors.white,
        ),
      ),
      payload: message.data["booking_id"], // 建议传递业务数据，而非通知内容
    );
  }
}

4. Firebase后台处理函数的说明 #

你的firebaseMessagingBackgroundHandler是处理Firebase后台消息推送的，和本地通知的后台点击回调完全独立，不会导致冲突。但注意：权限请求应该放在App前台初始化阶段，无需在后台函数中重复执行。

额外注意事项 #

• 确保目标页面已在路由表中注册。
• iOS平台需补充IOSInitializationSettings配置，并在Info.plist中开启通知权限。
• 后台回调必须是顶层函数（不能嵌套在类或其他函数内），且必须保留@pragma('vm:entry-point')注解，确保Flutter引擎能在后台环境找到它。

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