升级firebase_messaging至^14.6.8后无法接收Firestore通知

时隔许久重新维护项目，将firebase_messaging从^{13.0.4版本升级至}14.6.8版本后出现异常：回退至旧版本时可正常接收通知，且每次启动应用均能成功获取fcmToken（说明插件初始化正常），但通过FCM控制台测试时无法接收消息。

初始化代码 #

Future initialize(BuildContext context) async {
  await FirebaseMessaging.instance.setAutoInitEnabled(true);

  final fcmToken = await FirebaseMessaging.instance.getToken();
  print(fcmToken)

  await FirebaseMessaging.instance.setAutoInitEnabled(true);

  FirebaseMessaging.onMessage.listen((RemoteMessage message) { 
    print(message.notification)
   });
}

Flutter版本：3.13.2

排查建议 #

• 核对Android/iOS端适配配置：Android需确认Firebase SDK版本是否同步升级到与firebase_messaging v14.x匹配的版本；iOS需检查APNs证书、推送权限配置是否符合新版本要求。
• 确认通知权限已正确申请：iOS端在新版本中需显式请求通知权限，需添加权限申请代码，确保用户已授权通知权限。
• 检查消息监听覆盖场景：onMessage仅处理应用前台运行时收到的消息，若测试时应用处于后台或被杀死状态，需配置onBackgroundMessage后台消息处理逻辑，或查看系统通知栏是否有推送展示。
• 查看控制台日志：排查初始化过程中是否有权限拒绝、插件初始化失败等报错信息，以及Token获取后是否正常上传至业务服务器（若依赖服务器下发消息）。
• 检查Firebase插件版本兼容性：确认firebase_core等其他Firebase相关插件的版本与firebase_messaging v14.x兼容，避免版本冲突导致功能异常。

内容的提问来源于stack exchange，提问作者Edgar J.