Flutter+Firebase点击通知无法跳转深层链接，仅打开首页求助

核心问题分析 #

从代码和现象来看，主要存在以下几个关键问题点：

1. 路由路径存在语法错误
2. 导航上下文使用方式可能存在问题
3. 消息监听的初始化时机可能导致路由未就绪

具体修复步骤 #

1. 修正路由路径的语法错误 #

你的_handleMessage方法中，路由路径多了一个多余的闭合大括号}，这会导致go_router无法匹配到正确路由，从而自动 fallback 到首页。

错误代码：

context.go('/RMYCHANNELS/ROneChannel/$channelId}');

修正后：

context.go('/RMYCHANNELS/ROneChannel/$channelId');

2. 确保使用有效的导航上下文 #

直接使用context.go可能存在上下文未关联到GoRouter实例的情况，建议显式获取GoRouter实例来执行导航操作：

修改后的_handleMessage方法：

void _handleMessage(RemoteMessage message) {
  RemoteNotification? notification = message.notification;
  if (kDebugMode) {
    print("notification: $notification");
    print("message data: ${message.data}");
  }
  if (message.data['type'] == 'newArticle') {
    final channelId = message.data['channelId'];
    final articleId = message.data['articleId'];
    // 显式获取GoRouter实例执行导航
    GoRouter.of(context).go('/RMYCHANNELS/ROneChannel/$channelId');
  }
}

3. 延迟初始化消息监听，确保路由就绪 #

在initState中直接调用setupInteractedMessage可能会因为widget尚未完全挂载、GoRouter未初始化完成导致导航失效，建议使用addPostFrameCallback延迟执行：

修改后的initState：

@override
void initState() {
  super.initState();
  // 等待widget挂载完成后再初始化消息监听
  WidgetsBinding.instance.addPostFrameCallback((_) {
    setupInteractedMessage();
  });
  tokenListener = FirebaseMessaging.instance.onTokenRefresh.listen((fcmToken) {
    // 你的token刷新逻辑
  });
}

4. 验证推送Payload的正确性 #

确保Firebase推送的消息Payload中，data字段正确包含type、channelId参数，示例Payload结构如下：

{
  "data": {
    "type": "newArticle",
    "channelId": "your_channel_id",
    "articleId": "your_article_id"
  },
  "notification": {
    "title": "新文章通知",
    "body": "点击查看最新文章"
  },
  "to": "目标设备的FCM_TOKEN"
}

5. 确认后台启动场景的路由处理 #

当应用完全关闭时，点击通知会触发getInitialMessage，需要确保此时GoRouter已经完成初始化。可以在main函数中等待必要的初始化完成后再处理消息：

main函数补充：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  
  // 初始化GoRouter
  final goRouter = GoRouter(
    // 你的路由配置
    routes: [
      // ...
    ],
  );

  // 获取初始消息
  RemoteMessage? initialMessage = await FirebaseMessaging.instance.getInitialMessage();
  
  runApp(MyApp(router: goRouter, initialMessage: initialMessage));
}

然后在MyApp的initState中处理初始消息：

class MyApp extends StatefulWidget {
  final GoRouter router;
  final RemoteMessage? initialMessage;

  const MyApp({super.key, required this.router, this.initialMessage});

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  @override
  void initState() {
    super.initState();
    if (widget.initialMessage != null) {
      _handleMessage(widget.initialMessage!);
    }
    FirebaseMessaging.onMessageOpenedApp.listen(_handleMessage);
  }

  void _handleMessage(RemoteMessage message) {
    if (message.data['type'] == 'newArticle') {
      final channelId = message.data['channelId'];
      widget.router.go('/RMYCHANNELS/ROneChannel/$channelId');
    }
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp.router(
      routerConfig: widget.router,
    );
  }
}

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