Flutter使用flutter_local_notifications点击通知跳转页面问题及示例请求

问题分析 #

你当前的代码存在几个关键问题导致无法监听到流：

• 只实现了后台通知点击回调(onDidReceiveBackgroundNotificationResponse)，未处理前台通知点击回调(onDidReceiveNotificationResponse)
• 未确认configureDidReceiveLocalNotificationSubject方法是否在合适时机（比如初始化后）被调用
• 导航需要全局上下文支撑，直接在流监听中可能无法获取有效context

修复方案与最佳实践示例 #

1. 定义全局导航Key #

先创建全局导航Key，用于在通知回调中获取导航上下文：

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

2. 完善通知初始化逻辑 #

同时处理前台、后台的通知点击回调，确保权限请求逻辑严谨：

final BehaviorSubject<String?> selectNotificationSubject = BehaviorSubject<String?>();
final FlutterLocalNotificationsPlugin flutterLocalNotificationsPlugin = FlutterLocalNotificationsPlugin();

void initializeNotifications() async {
  // Android初始化配置
  const AndroidInitializationSettings initializationSettingsAndroid =
      AndroidInitializationSettings('@mipmap/ic_launcher');
  
  final InitializationSettings initializationSettings =
      InitializationSettings(android: initializationSettingsAndroid);

  // 同时绑定前台、后台点击回调
  await flutterLocalNotificationsPlugin.initialize(
    initializationSettings,
    onDidReceiveNotificationResponse: (NotificationResponse response) {
      // 前台点击通知触发
      selectNotificationSubject.add(response.payload);
    },
    onDidReceiveBackgroundNotificationResponse: (NotificationResponse response) {
      // 后台点击通知触发
      selectNotificationSubject.add(response.payload);
    },
  );

  // 请求通知权限
  final AndroidFlutterLocalNotificationsPlugin? androidImplementation =
      flutterLocalNotificationsPlugin.resolvePlatformSpecificImplementation<AndroidFlutterLocalNotificationsPlugin>();
  await androidImplementation?.requestPermission();
}

3. 正确订阅流并实现导航 #

确保订阅方法被调用，通过全局导航Key完成页面跳转：

void configureNotificationSubject() {
  selectNotificationSubject.stream.listen((String? payload) async {
    if (payload != null && navigatorKey.currentContext != null) {
      // 根据payload跳转到目标页面，示例为SecondPage
      await navigatorKey.currentState!.pushNamed(
        '/secondPage',
        arguments: payload, // 传递自定义参数
      );
    }
  });
}

4. 在MaterialApp中配置全局导航Key #

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      navigatorKey: navigatorKey, // 绑定全局导航Key
      initialRoute: '/',
      routes: {
        '/': (context) => const HomePage(),
        '/secondPage': (context) => const SecondPage(),
      },
    );
  }
}

5. 调用初始化与订阅方法 #

在应用启动时执行初始化逻辑：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await initializeNotifications();
  configureNotificationSubject();
  runApp(const MyApp());
}

额外注意事项 #

• 发送通知时需正确设置payload，确保跳转逻辑能拿到有效参数：

Future<void> showTestNotification() async {
  const AndroidNotificationDetails androidDetails = AndroidNotificationDetails(
    'channel_id',
    'channel_name',
    importance: Importance.high,
    priority: Priority.high,
  );
  const NotificationDetails notificationDetails = NotificationDetails(android: androidDetails);
  await flutterLocalNotificationsPlugin.show(
    0,
    '测试通知',
    '点击跳转至第二页',
    notificationDetails,
    payload: 'second_page_params', // 自定义参数
  );
}

• 若应用被完全杀死后需通过后台通知唤醒并跳转，需额外配置AndroidManifest.xml（参考插件官方文档的后台处理章节）

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