Flutter本地通知点击跳转异常：依赖应用启动方式问题排查

问题复现场景 #

• 正常流程：应用终止→手动启动应用→应用处于前台/后台或再次关闭→收到本地通知点击→应用回到前台，成功导航至AddShoppingItemScreen页面
• 异常流程：应用终止→点击通知启动应用（首次导航正常）→应用处于前台/后台→再次点击通知→仅回到前台，无导航行为
• 仅Android模拟器出现该问题，iOS设备无异常

可能原因与解决方案 #

1. 确保全局导航上下文可访问 #

应用通过通知冷启动时，MaterialApp的导航上下文可能未完全初始化，后续通知点击若使用临时上下文或未持有全局导航Key，会导致导航失效。

处理步骤：

• 在main.dart中定义全局导航Key：

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

• 将Key绑定到MaterialApp：

MaterialApp(
  navigatorKey: navigatorKey,
  onGenerateRoute: RouteGenerator.generateRoute,
  // 其他配置项
)

• 在local_notifications_service.dart的通知点击回调中，使用全局Key执行导航：

Future<void> _onNotificationTap(NotificationResponse response) async {
  if (navigatorKey.currentState != null) {
    navigatorKey.currentState!.pushNamed('/add-shopping-item');
  }
}

2. 修正Android Activity启动模式 #

Android中，默认启动模式下通过通知打开应用可能创建新的Activity实例，导致后续通知点击的上下文并非当前活跃的导航上下文。

处理步骤：

• 修改AndroidManifest.xml中主Activity的启动模式为singleTop：

<activity
    android:name=".MainActivity"
    android:launchMode="singleTop">
    <!-- 其他原有配置 -->
</activity>

3. 统一冷启动与热启动的通知处理逻辑 #

冷启动时需通过getInitialNotification获取通知参数，热启动时通过onNotificationTap回调，需确保两种场景的导航逻辑一致。

处理步骤：

• 在main.dart的初始化流程中处理冷启动通知：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await LocalNotificationsService.initialize();

  // 处理冷启动时的通知点击
  final NotificationResponse? initialNotification =
      await LocalNotificationsService.getInitialNotification();
  if (initialNotification != null) {
    WidgetsBinding.instance.addPostFrameCallback((_) {
      navigatorKey.currentState?.pushNamed('/add-shopping-item');
    });
  }

  runApp(MyApp());
}

• 在local_notifications_service.dart中确保回调逻辑统一：

void initialize() {
  final InitializationSettings initializationSettings = InitializationSettings(
    android: AndroidInitializationSettings('@mipmap/ic_launcher'),
    iOS: IOSInitializationSettings(),
  );

  flutterLocalNotificationsPlugin.initialize(
    initializationSettings,
    onDidReceiveNotificationResponse: _onNotificationTap,
    onDidReceiveBackgroundNotificationResponse: _onNotificationTap,
  );
}

4. 检查路由生成器逻辑 #

确保route_generator.dart中，无论应用启动状态如何，都能正确解析并导航到目标页面，不依赖特定页面状态：

Route<dynamic> generateRoute(RouteSettings settings) {
  switch (settings.name) {
    case '/':
      return MaterialPageRoute(builder: (_) => ShoppingItemListScreen());
    case '/add-shopping-item':
      return MaterialPageRoute(builder: (_) => AddShoppingItemScreen());
    default:
      return MaterialPageRoute(builder: (_) => ShoppingItemListScreen());
  }
}

验证步骤 #

1. 终止应用，点击通知启动，确认首次导航正常
2. 将应用切换到后台，发送新通知并点击，确认导航触发
3. 应用处于前台时，重复通知点击测试，验证导航行为正常

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