Flutter_local_notifications iOS端配置：如何正确修复onDidReceiveLocalNotification示例代码无法开箱即用的问题

我刚踩过类似的坑，官方示例确实没把这两个关键点讲透，下面给你一步步的修复方案：

一、参数传递问题：直接使用回调传入的值 #

其实这个回调里的id、title、body、payload是系统在触发通知时自动传递过来的——只要你在初始化iOSInitializationSettings时正确注册了这个回调，当用户点击通知（或通知弹出时，取决于iOS版本），这些参数就会自动传入。

需要注意：iOS某些场景下这些参数可能为空（比如静默推送），建议做null安全处理，避免崩溃。

二、获取showDialog的Context：用全局NavigatorKey #

因为onDidReceiveLocalNotification通常是顶层函数，不在Widget树的上下文范围内，没法直接拿到BuildContext。最可靠的解决方式是用全局的NavigatorState key：

步骤1：定义全局NavigatorKey #

在项目入口文件（比如main.dart）里声明一个全局key：

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

步骤2：绑定到MaterialApp #

把这个key关联到你的应用导航栈：

MaterialApp(
  navigatorKey: navigatorKey, // 绑定全局key
  title: '你的应用名称',
  home: const HomeScreen(),
  // 其他配置...
)

步骤3：在回调中通过全局key获取Context #

修改你的回调函数，安全获取上下文并使用参数：

void onDidReceiveLocalNotification(
  int id, String? title, String? body, String? payload) async {
  // 处理参数null情况
  final notificationTitle = title ?? '新通知';
  final notificationBody = body ?? '您收到一条本地通知';

  // 先判断上下文是否有效，避免空指针
  final currentContext = navigatorKey.currentContext;
  if (currentContext != null) {
    showDialog(
      context: currentContext,
      builder: (BuildContext context) => CupertinoAlertDialog(
        title: Text(notificationTitle),
        content: Text(notificationBody),
        actions: [
          CupertinoDialogAction(
            isDefaultAction: true,
            child: const Text('Ok'),
            onPressed: () async {
              // 关闭弹窗
              Navigator.of(context, rootNavigator: true).pop();
              // payload不为空时跳转页面
              if (payload != null) {
                await Navigator.push(
                  context,
                  MaterialPageRoute(
                    builder: (context) => SecondScreen(payload),
                  ),
                );
              }
            },
          )
        ],
      ),
    );
  }
}

步骤4：初始化时注册回调 #

最后确保在插件初始化时把这个回调传给iOS配置：

// iOS初始化配置
final iOSInitializationSettings iosSettings = iOSInitializationSettings(
  onDidReceiveLocalNotification: onDidReceiveLocalNotification,
  // 可选：添加其他iOS权限配置，比如requestAlertPermission: true
);

// 全局初始化设置
final InitializationSettings initializationSettings = InitializationSettings(
  iOS: iosSettings,
  // Android端配置...
);

// 初始化插件
await flutterLocalNotificationsPlugin.initialize(initializationSettings);

这样两个问题就都解决了：参数直接用回调传入的值，上下文通过全局NavigatorKey安全获取。

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