Flutter中OneSignal结合go_router：代码位置与指定页面跳转问题

1. 通知打开回调代码的放置位置 #

直接放在main函数里，在初始化OneSignal之后、runApp之前。

原因很明确：OneSignal的回调属于应用全局初始化逻辑，必须在应用启动初期完成注册，才能捕获所有通知打开事件（包括应用从后台冷启动的场景）。如果放在MaterialApp.router的配置环节，会延迟回调注册，可能导致部分通知事件被遗漏。

示例代码结构：

void main() async {
  // 先初始化OneSignal
  await OneSignal.shared.setAppId("你的AppID");
  
  // 注册通知打开回调
  OneSignal.shared.setNotificationOpenedHandler((OSNotificationOpenedResult result) {
    OSNotification payload = result.notification;
    print('OneSignal: notification opened: ${result}');
  });

  // 初始化go_router
  final router = GoRouter(
    routes: [/* 你的路由配置 */],
  );

  // 启动App
  runApp(MaterialApp.router(routerConfig: router));
}

2. 点击通知打开指定页面的实现方法 #

不需要额外给go_router加监听器，直接在通知打开的回调里调用go_router的跳转方法即可，核心是确保router实例能在回调中被访问到。

具体步骤： #

1. 让router全局可访问：可以把router定义成全局变量，方便在无context的回调里直接调用。
2. 推送通知时携带路由信息：在OneSignal后台推送通知时，给additionalData字段添加目标路由的path，比如{"route": "/order-detail"}。
3. 在回调中执行跳转：从payload里取出路由信息，调用router.go()完成跳转。

示例代码：

// 全局定义router，方便回调里调用
late final GoRouter router;

void main() async {
  await OneSignal.shared.setAppId("你的AppID");
  
  OneSignal.shared.setNotificationOpenedHandler((OSNotificationOpenedResult result) {
    OSNotification payload = result.notification;
    // 从推送的附加数据里拿目标路由
    String? targetRoute = payload.additionalData?['route'];
    if (targetRoute != null) {
      // 直接跳转指定页面
      router.go(targetRoute);
    }
    print('OneSignal: notification opened: ${result}');
  });

  // 初始化全局router
  router = GoRouter(
    routes: [
      GoRoute(path: '/', builder: (ctx, state) => const HomePage()),
      GoRoute(path: '/order-detail', builder: (ctx, state) => const OrderDetailPage()),
    ],
  );

  runApp(MaterialApp.router(routerConfig: router));
}

如果需要传递页面参数（比如订单ID），可以在additionalData里添加参数，比如{"route": "/order-detail", "orderId": "123"}，然后在回调里拼接路由：

String? orderId = payload.additionalData?['orderId'];
if (targetRoute != null && orderId != null) {
  router.go('$targetRoute?id=$orderId');
}

对应的路由配置也要接收参数：

GoRoute(
  path: '/order-detail',
  builder: (ctx, state) {
    final orderId = state.queryParameters['id'];
    return OrderDetailPage(orderId: orderId);
  },
);

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