Flutter后台通知处理函数报错及点击通知启动第三方应用问题

核心问题拆解 #

你碰到的错误根源是给onDidReceiveBackgroundNotificationResponse传的不是函数引用，而是直接调用函数后的结果。另外还有两个隐藏问题会导致逻辑失效：

• 后台处理函数无法访问类内部定义的flutterLocalNotificationsPlugin实例
• 直接把Id和type传给后台函数的方式行不通，后台环境没法保留这些变量

分步修复方案 #

1. 修正初始化时的回调传递 #

在PushNotification类的setNotification方法里，onDidReceiveBackgroundNotificationResponse要直接传函数本身，不能加括号调用；同时把Id和type打包进通知的payload里，让后台函数能拿到参数：

await flutterLocalNotificationsPlugin.initialize(
  initializationSettings,
  onDidReceiveNotificationResponse: (details) async {
    // 前台点击时从payload解析参数
    final payload = details.payload;
    if (payload != null) {
      final parts = payload.split(',');
      await notificationOpenHandler(parts[0], parts[1]);
    }
  },
  // 直接传函数引用，不要调用它
  onDidReceiveBackgroundNotificationResponse: notificationBackOpenHandler,
);

// 发送通知时把Id和type打包成payload
await flutterLocalNotificationsPlugin.show(
  id,
  title,
  body,
  iOSPlatformChannelSpecifics,
  payload: '$id,$type', // 用逗号分隔参数，方便后续解析
);

2. 把FlutterLocalNotificationsPlugin实例移到顶级作用域 #

后台处理函数是顶级函数，没法访问类内部的实例，所以要在文件最外层定义这个实例：

// 顶级作用域定义实例，让后台函数能访问到
final FlutterLocalNotificationsPlugin flutterLocalNotificationsPlugin = FlutterLocalNotificationsPlugin();

class PushNotification {
  // ... 你的类代码
}

3. 修正后台处理函数的参数和逻辑 #

后台函数要从NotificationResponse的payload里解析参数，不能依赖外部传入的变量：

@pragma('vm:entry-point')
Future<void> notificationBackOpenHandler(NotificationResponse details) async {
  // 从payload里取出Id和type
  final payload = details.payload;
  if (payload == null) return;
  
  final parts = payload.split(',');
  final id = parts[0];
  final type = parts[1];

  NotificationAppLaunchDetails? launchDetail =
      await flutterLocalNotificationsPlugin.getNotificationAppLaunchDetails();
  debugPrint('_notificationBackOpenHandler launchDetail: $launchDetail');

  final Uri flutterUrl = Uri.parse(
      'https://liff.line.me/{liffid}/{urlname}?id=$id');

  await launchUrl(
    flutterUrl,
    mode: LaunchMode.externalApplication,
  );
}

关键注意点 #

• @pragma('vm:entry-point')必须保留，它是告诉Flutter编译器这个函数是后台入口，不能被混淆或移除
• 后台函数里不能用任何类内部的状态或实例，所有需要的数据都得通过通知的payload传递
• iOS端要确保已经配置好通知权限和后台模式（在Xcode的Capabilities里开启Background Modes -> Remote notifications）

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