Flutter本地通知仅在活跃状态下可捕获Payload问题

问题本质 #

你当前仅通过onDidReceiveNotificationResponse处理通知点击，但这个回调只在应用处于前台活跃状态时触发。当应用处于后台或完全终止状态时，点击通知唤醒/启动应用，该回调不会执行，导致无法获取Payload。

解决方案 #

需要补充两个核心处理逻辑，覆盖应用全状态下的通知点击场景：

1. 配置后台通知响应回调 #

在初始化插件时添加onDidReceiveBackgroundNotificationResponse参数，这个回调会在应用后台或终止状态下处理通知点击。注意：该回调必须是顶级函数或静态方法，不能是类的实例方法（后台环境无法访问实例对象）。

2. 检查应用启动时的初始通知Payload #

当应用从通知点击启动时，需要主动获取启动来源的通知Payload，再执行对应逻辑。

修改后的初始化代码如下：

Future<void> _initializeFlutterLocalNotifications() async {
  const AndroidInitializationSettings initializationSettingsAndroid = AndroidInitializationSettings('@mipmap/ic_launcher');
  const InitializationSettings initializationSettings = InitializationSettings(android: initializationSettingsAndroid);

  // 后台通知处理回调（顶级函数）
  void _backgroundNotificationHandler(NotificationResponse response) {
    print('Background notification clicked with payload: ${response.payload}');
    // 可将Payload保存到本地存储（如SharedPreferences），供应用启动后读取
  }

  await flutterLocalNotificationsPlugin.initialize(
    initializationSettings,
    onDidReceiveNotificationResponse: (NotificationResponse response) async {
      print('Foreground notification clicked with payload: ${response.payload}');
      _handleNotificationClick(response.payload);
    },
    // 新增后台回调
    onDidReceiveBackgroundNotificationResponse: _backgroundNotificationHandler,
  );

  // 检查应用是否从通知点击启动
  final NotificationAppLaunchDetails? launchDetails =
      await flutterLocalNotificationsPlugin.getNotificationAppLaunchDetails();
  if (launchDetails?.didNotificationLaunchApp ?? false) {
    final String? payload = launchDetails?.notificationResponse?.payload;
    if (payload != null) {
      _handleNotificationClick(payload);
    }
  }
}

补充：完善Payload处理逻辑 #

确保_handleNotificationClick能适配应用启动后的场景，比如根据Payload导航到对应页面：

void _handleNotificationClick(String? payload) {
  if (payload == null) return;
  // 示例：根据Payload导航到目标页面
  Navigator.of(context).pushNamed('/targetPage', arguments: payload);
}

关键注意点 #

• 后台回调中避免执行UI操作，优先将Payload持久化，等待应用前台后再处理。
• 确保Android平台已配置通知通道（Android 8.0+要求），权限配置完整。

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